무엇을 찾는 명령인가

git bisect는 정상으로 확인한 good 커밋과 문제가 재현되는 bad 커밋 사이에서 첫 bad 후보를 찾습니다. index나 remote 설정이 아니라 커밋 범위를 같은 기준으로 반복 검사합니다.

기본 흐름

git bisect start
git bisect bad HEAD
git bisect good v1.4.0
# 선택된 커밋을 검사한 뒤
git bisect good   # 정상
git bisect bad    # 회귀
git bisect reset

두 끝점에서 실행 환경과 판정 방법이 같아야 합니다. 조사 전에는 작업 중인 변경도 안전하게 보관합니다.

결과를 해석할 때

Git이 제시한 커밋은 판정 테스트를 기준으로 한 첫 bad 후보입니다. 테스트가 간헐적으로 실패하거나 회귀가 중간에 사라졌다 다시 생기면 한 번의 결과로 원인을 확정할 수 없습니다.

공식 문서