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 приводит всё в порядок, даже если вы уже успели запутаться, где находитесь. Перед экспериментом заведите ветку, и руки перестанут дрожать.