hellno / заметки

git bisect спас вечер

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

Логика bisect примитивна и потому честна: вы знаете коммит, где всё работало, и коммит, где уже не работает, а дальше git сам делает двоичный поиск по истории. Дорого стоит не поиск, а проверка — на ней и стоит сосредоточиться.


git bisect start

git bisect bad

git bisect good v2.4.1

git bisect run ./check.sh

git bisect reset

check.sh должен возвращать ноль, когда всё хорошо, и ненулевой код, когда сломано. Вся ответственность за правду лежит на нём, поэтому у него есть три требования. Он должен собираться с нуля: если из-за кэша тест видит артефакты предыдущей итерации, бисект врёт уверенно и красиво. Он не должен ничего чинить сам: автостайлинг, миграции и «давай я перезапишу конфиг» превращают поиск в лотерею. И он должен падать по делу, а не по таймауту окружения, иначе половину истории вы отбросите зря.

У меня проверка — сборка плюс один короткий интеграционный тест, секунд двадцать. Из двухсот с лишним коммитов бисект выдал один, и в нём, как обычно, была строчка про порядок инициализации, которую я глазами бы не нашёл никогда.

Отдельная радость: git bisect reset приводит всё в порядок, даже если вы уже успели запутаться, где находитесь. Перед экспериментом заведите ветку, и руки перестанут дрожать.

← к списку записей