Что такое покрытие кода — и почему 100% не значит «проверено»

Смотри, какая обидная штука: можно написать тест, в котором нет ни одной проверки — просто вызвать функцию и ничего не сравнить. И покрытие кода честно покажет 100%. Отчёт зелёный, а не проверено ничего. Разберёмся, что такое покрытие на самом деле и как им пользоваться, не обманывая себя.
Что такое покрытие кода простыми словами
Покрытие кода (code coverage) — это доля строк твоей программы, которые выполнились, пока шли тесты.
Работает так: инструмент запускает тесты и одновременно ставит галочку на каждой строке, до которой дошло выполнение. В конце делит помеченные строки на все. Получилось 68% — значит, две трети кода при прогоне тестов хотя бы разок отработали, а треть не выполнялась ни разу.
Аналогия — стена лампочек, где каждая лампочка это строка кода. Запускаешь тесты: лампочки загораются одна за другой. Покрытие — это сколько лампочек горит. И вот тут вся соль: горящая лампочка говорит только о том, что через строку прошли. Не о том, что результат кто-то посмотрел.
Главный подвох: покрытие меряет запуск, а не проверку
Отсюда простое правило, которое экономит месяцы самообмана:
Покрытие — это метрика исполнения, а не метрика корректности.
Вызвал функцию расчёта скидки, не сравнил результат ни с чем — строки исполнились, покрытие выросло, а работает функция или нет, ты по-прежнему не знаешь. Тест без утверждения (assert) — это не тест, а прогулка по коду.
Особенно легко наступить на это, когда тесты пишет ИИ. Попроси «подними покрытие» — и получишь ровно то, что просил: вызовы всех функций, минимум содержательных проверок. Поэтому в работе с ИИ над тестами первым делом читай не количество тестов, а их утверждения: что именно сравнивается и с каким ожидаемым значением. Кстати, это же причина, по которой код от ИИ бывает с багами при зелёных тестах.
Строки и ветки — две разные цифры
В отчёте обычно есть минимум два числа, и путать их дорого.
- Покрытие строк (line coverage) — сколько строк выполнилось. Самая популярная и самая обманчивая цифра.
- Покрытие ветвей (branch coverage) — сколько развилок пройдено в обе стороны. У каждого условия «если» два исхода; строка считается покрытой, даже если ты проверил только один из них.
Пример: функция с условием «если пользователь не найден — вернуть ошибку». Тест с существующим пользователем прогоняет строку с условием, и покрытие строк рад. А ветка «не найден» не исполнялась ни разу — именно та, которая падает в проде. Покрытие ветвей это увидит, покрытие строк — нет.
Вывод: смотри на ветки. Если инструмент их считает, включай.
Как пользоваться покрытием и не врать себе
Три практических привычки:
- Читай не процент, а отчёт. Почти любой инструмент рисует файл с подсветкой: зелёное — исполнялось, красное — нет. Ценность именно в красном. Смотри на него и спрашивай: «это место опасное?»
- Не делай процент целью. Как только за цифру начинают отчитываться, её начинают накручивать пустыми тестами — закон известный. Покрытие хорошо работает как индикатор и плохо как KPI.
- Не гонись за одинаковым числом везде. Логика оплаты и расчёта прав доступа заслуживает почти полного покрытия. Вёрстка страницы «о нас» — нет. Покрытие 100% на всём проекте обычно означает гору бессмысленных тестов, которые потом мешают менять код и превращаются в технический долг.
Есть и более честный инструмент — мутационное тестирование. Он специально портит твой код (меняет плюс на минус, условие на противоположное) и смотрит, упадут ли тесты. Если не упали — тесты ничего не проверяют, каким бы ни было покрытие. Штука медленная, но один прогон по важному модулю очень отрезвляет.
Какой процент покрытия считается нормальным?
Универсального числа нет, и любой, кто называет его без контекста, лукавит. Рабочий ориентир: критичная бизнес-логика — 80% и выше по веткам, остальное — сколько получится. Гораздо важнее, чтобы покрытие не падало от изменения к изменению: это удобно повесить проверкой в CI/CD.
Нужно ли покрытие, если код пишет ИИ?
Нужно даже больше. Ты читаешь чужой код глазами и легко пропускаешь необработанную ветку — а отчёт покрытия покажет её механически. Только не проси ИИ «сделать 100%»: проси тест на конкретную ветку, которая осталась красной.
Чем покрытие отличается от количества тестов?
Количество тестов вообще ни о чём не говорит: сто тестов могут топтаться в одной функции. Покрытие отвечает на другой вопрос — какие части кода вообще остались нетронутыми. Это разные вопросы, и ни один из них не отвечает на третий: «а правильно ли работает программа».
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





