Табличные тесты в Go с подтестами

Цель

Проверить множество входных данных одной функции в одном понятном тесте, где для нового случая достаточно добавить строку, а имя неудачного случая выводится в результатах.

Предварительные условия

Функция с чётким контрактом входных и выходных данных, стандартный пакет testing без необходимости в дополнительном фреймворке и механизм подтестов, описанный в разделе «Subtests and Sub-benchmarks»: t.Run(name, func(t *testing.T)) создаёт именованный подтест, полное имя которого состоит из имени родительского теста и имени подтеста, соединённых косой чертой.

Порядок действий

1. Определите таблицу как срез анонимных структур с полем name, входными данными, ожидаемым результатом и, где нужно, wantErr bool либо сигнальной ошибкой для сопоставления через errors.Is.
2. Выполните цикл for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { ... }) }. Начиная с Go 1.22, для модулей, в чьём go.mod указана версия 1.22 или новее, у каждой итерации есть собственная переменная tc, поэтому замыкания захватывают правильный случай. На странице вики показано копирование на каждой итерации, необходимое в более старых версиях.
3. Внутри подтеста вызовите функцию один раз, затем сравните результат: используйте t.Errorf, чтобы записать ошибку и продолжить, и t.Fatalf, если последующие проверки уже не имеют смысла, например когда предстоит разыменовать результат nil.
4. Вынесите повторяющуюся подготовку во вспомогательную функцию, которая сначала вызывает t.Helper(), чтобы сообщение об ошибке указывало на строку теста, а не помощника; зарегистрируйте очистку через t.Cleanup.
5. Помечайте независимые подтесты вызовом t.Parallel(), если функцию безопасно вызывать конкурентно. Документация указывает, что Run, объединяющий параллельные подтесты, возвращается только после их завершения; это позволяет выполнить очистку после всей группы.
6. При отладке запускайте один случай: go test -run 'TestParse/empty_input'. Аргумент -run разделяется косыми чертами и поочерёдно сопоставляется с каждой частью имени.
7. Обнаружив ошибку, добавьте вызывающие её входные данные новой строкой, прежде чем исправлять код.

Ожидаемый результат

Файл тестов, в котором случаи читаются как таблица спецификации; вывод наподобие --- FAIL: TestParse/negative_width сразу указывает на нужную строку, а новый случай требует одной строки.

Ограничения и основание проверки

Таблицы подходят для чистых функций и небольших конечных автоматов. Они становятся неудобными, когда случаям нужна разная подготовка или разные проверки; тогда отдельные тесты понятнее таблицы, полной необязательных полей. Имена случаев входят в шаблон -run, который является регулярным выражением, поэтому делайте их короткими, уникальными и без метасимволов. Процедура следует указанной документации пакета testing и странице Go wiki о табличных тестах.