git bisectでバグの原因コミットを特定する - 二分探索デバッグ

問題

ある時点からバグが発生しましたが、コミットが数百件あり、一つずつ確認するのは不可能でした。「先週までは動いていたのに…」と繰り返すばかりでした。

git bisectは二分探索でバグを導入したコミットを見つけてくれます。1024個のコミットでも10回の確認で済みます。

# bisectを開始
git bisect start

# 現在の状態（バグあり）をbadとしてマーク
git bisect bad

# バグがなかった時点をgoodとしてマーク
git bisect good abc1234

gitが中間のコミットにチェックアウトしてくれます。テストして結果を報告します。

# このコミットにバグがある場合
git bisect bad

# このコミットにバグがない場合
git bisect good

# 繰り返すと原因コミットを特定してくれます
# "abc5678 is the first bad commit"

テストスクリプトがあれば完全自動化も可能です。

# スクリプトの終了コード0ならgood、それ以外ならbad
git bisect run npm test

# または特定のスクリプトを指定
git bisect run ./check-bug.sh

終了したら元のブランチに戻ります。

git bisect reset