basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Найти, где сломалось: log, blame и bisect

    Что-то работало неделю назад и не работает сейчас. git log -S находит коммит, где появилась или пропала строка, git blame — кто и когда последним менял строку, а git bisect делением пополам находит сломавший коммит среди сорока за пять-шесть проверок — и может проверять сам.

    Каким инструментом искать

    Что знаем Чем ищем
    строку, которая появилась или пропала: timeout: 0, имя функции git log -S'timeout: 0'
    строку по шаблону, а не точно git log -G'timeout: [0-9]+'
    файл и примерное время git log --since=2026-10-10 -p -- app.yml
    конкретную строку файла: кто и зачем git blame -L 40,60 app.yml
    только «раньше работало, теперь нет» git bisect

    По строке: log -S и -G

    git log -S'timeout: 0' --oneline
    # 2f1396d step 27

    -S ищет коммиты, в которых число вхождений строки изменилось: строку добавили или удалили. -G — коммиты, где строка, подходящая под регулярное выражение, есть в правке. С -p показывает и сами правки.

    По строке файла: blame

    git blame -L 1,1 app.yml
    # 2f1396d6 (t 2026-10-18 22:54:38 +0300 1) timeout: 0

    Хэш, автор, дата, номер строки. Дальше — git show 2f1396d6: что ещё поменяли этим коммитом и что написали в сообщении. Поэтому сообщение «зачем», а не «fix», окупается именно здесь («Git на каждый день»).

    • -w — не считать правкой пробелы и отступы.
    • -C — найти строку, перенесённую из другого файла.
    • git log -L 40,60:app.yml — вся история этих строк, коммит за коммитом.

    Делением пополам: bisect

    Есть хороший коммит (неделю назад работало) и плохой (сейчас). Между ними 40 коммитов. Git берёт середину, мы проверяем — хорошо или плохо, — и половина отбрасывается. 40 коммитов — за 5–6 проверок, 1000 — за 10.

    1. Начинаем и отмечаем границы

      git bisect start
      git bisect bad                 # текущий коммит — плохой
      git bisect good v1.2.0         # тег, хэш или HEAD~40 — хороший
      # Bisecting: 19 revisions left to test after this (roughly 4 steps)
      # [9f4de09a…] step 20

      Git переключился на коммит посередине — HEAD теперь не на ветке, так и задумано.

    2. Проверяем и отмечаем

      Проверяем, как угодно: собираем, запускаем, открываем страницу. Потом:

      git bisect good    # на этом коммите работает
      git bisect bad     # не работает
      git bisect skip    # проверить нельзя — сломано другое

      И так, пока git не скажет:

      2f1396d65bf74b468767c2a9d12af792a120510c is the first 'bad' commit
          step 27
    3. Или пусть проверяет скрипт

      Если поломку ловит команда, git пройдёт поиск сам. Код выхода 0 — хорошо, 1–124 и 126–127 — плохо, 125 — пропустить:

      git bisect start HEAD v1.2.0
      git bisect run npm run build

      Для этого сайта — сломалась сборка где-то за последние два десятка коммитов: git bisect run sh -c 'npm ci && npm run build'. Для конфига — проверка строки:

      git bisect run sh -c '! grep -q "timeout: 0" app.yml'
      # Bisecting: 9 revisions left to test after this (roughly 3 steps)
      # …
      # 2f1396d65bf74b468767c2a9d12af792a120510c is the first 'bad' commit
    4. Заканчиваем

      git bisect reset
      # Switched to branch 'main'

      Без reset HEAD так и останется на последнем проверенном коммите.

    Нашли коммит — дальше по ситуации: git show — что в нём, git revert — отменить, если он уже на GitHub («Отменить в git»).

    Если не работает

    git bisect уводит не туда, найденный коммит ни при чём

    Причина
    Одну из проверок отметили неверно: good вместо bad — и половина истории отброшена зря.
    Делаем
    git bisect log — все отметки; git bisect reset и заново, или git bisect replay с исправленным логом.

    bisect run отметил всё как bad, хотя старые коммиты точно рабочие

    Причина
    Скрипт падает по другой причине: нет зависимостей, другая версия Node, кэш сборки.
    Делаем
    Пробуем скрипт руками на заведомо хорошем коммите: git switch --detach a1b2c3 && npm ci && npm run build.

    Коммит не собирается вовсе — ни хорошо, ни плохо

    Причина
    Промежуточный коммит со сломанной сборкой по другой причине.
    Делаем
    git bisect skip — git возьмёт соседний. В скрипте — выход с кодом 125.

    git blame показывает коммит, где только переформатировали файл

    Причина
    Последним строку трогал коммит с отступами или переносом строк.
    Делаем
    git blame -w — без учёта пробелов; для массовых переформатирований — список в .git-blame-ignore-revs и git config blame.ignoreRevsFile .git-blame-ignore-revs.

    После bisect проект в странном состоянии, git status пишет HEAD detached

    Причина
    Поиск не закончили командой reset: HEAD остался на проверяемом коммите.
    Делаем
    git bisect reset — вернёт на ветку, с которой начинали.

    Как проверить

    Найденный коммит правда виноват — проверяем его и родителя:

    git switch --detach 2f1396d~1 && npm run build    # родитель — собирается
    git switch --detach 2f1396d   && npm run build    # сам коммит — нет
    git switch main