Что такое Git Bisect?

Что такое Git Bisect?

Git Bisect — это мощный инструмент в системе контроля версий Git, предназначенный для автоматизированного поиска коммита, который впервые вызвал ошибку (bug) или проблему в проекте. Это процесс бинарного поиска (binary search) по истории коммитов, который позволяет быстро и эффективно локализовать проблемный коммит, даже в очень длинной истории изменений.

Как работает алгоритм бинарного поиска в Git Bisect?

Алгоритм делит историю коммитов на промежутки и систематически проверяет их, сокращая область поиска вдвое на каждом шаге. Вместо того чтобы проверять каждый коммит линейно (что в большом проекте может означать сотни или тысячи проверок), bisect требует всего около log2(N) проверок для N коммитов. Например, для 1000 коммитов потребуется примерно 10 проверок.

Основные команды и процесс работы

Процесс обычно начинается, когда вы обнаружили, что текущая версия (HEAD) содержит ошибку, а в какой-то точке прошлого (например, в известном старом релизе) этой ошибки не было.

1. Начало процесса: Вы указываете Git «хороший» (good) коммит, где проблема отсутствовала, и «плохой» (bad) коммит, где проблема присутствует.

git bisect start
git bisect bad HEAD      # текущий коммит считается проблемным
git bisect good v1.0     # или хэш коммита старого релиза

1. Автоматическая проверка: Git автоматически перемещается к коммиту, примерно посередине между указанными точками, и проверяет его состояние. Вам необходимо протестировать этот коммит (например, запустить тесты или проверить функциональность) и сообщить Git результат:

# Если в текущем проверяемом коммите ошибка ЕСТЬ:
git bisect bad

# Если в текущем проверяемом коммите ошибки НЕТ:
git bisect good

1. Продолжение поиска: Git будет продолжать перемещаться по истории, деля остающийся диапазон пополам на основе ваших ответов, пока не найдет первый плохой коммит. Когда такой коммит найден, Git сообщит его хэш, автор, дату и сообщение.

2df5c7a is the first bad commit
Author: John Doe
Date:   Mon Mar 10 12:34:56 2023 +0300

    Refactored user authentication module

1. Завершение процесса: После обнаружения проблемного коммита необходимо завершить процесс bisect.

git bisect reset   # возвращает рабочее дерево и HEAD в исходное состояние

Практическое применение и пример сценария

Предположим, в вашем iOS приложении после последних изменений начал падать тест LoginTests. Вы знаете, что месяц назад, в коммите a1b2c3d, все тесты проходили успешно.

• Вы запускаете git bisect start.
• Указываете текущий HEAD как bad.
• Указываете a1b2c3d как good.
• Git перемещает вас на промежуточный коммит. Вы запускаете набор тестов (xcodebuild test или через fastlane).
• Если тест падает — отмечаете коммит как bad. Если проходит — как good.
• После нескольких таких шагов (обычно 5-10) Git идентифицирует коммит, где тест впервые начал падать. Это именно то изменение, которое вызвало проблему.

Ключевые преимущества Git Bisect для iOS разработчика

• Эффективность: Сокращает время поиска корня проблемы с дней до часов или минут.
• Автоматизация: Можно автоматизировать процесс проверки, используя скрипты. Например, для iOS проекта можно создать скрипт, который для каждого коммита запускает сборку и ключевые unit-тесты.
• Точность: Позволяет точно определить не только коммит, но и конкретное изменение (diff), которое привело к регрессии.
• Интеграция в рабочий процесс: Особенно полезен при работе с большими командами, частыми мержами и длинной историей, где источник бага трудно определить интуитивно.

Git Bisect превращает сложную задаку «поиска виновника» в управляемый, систематический процесс, значительно повышая эффективность разработки и отладки в iOS проектах.