git bisectで、不具合が入ったコミットを探す方法

​​Git​コマンドライン,シェルスクリプト

「前のバージョンでは動いていたのに、いつの間にか壊れていた」というデグレード(リグレッション)の原因を探すときは、git bisect を使います。動いていたコミット(good)と壊れているコミット(bad)を1つずつ伝えると、Git がその間のコミットを二分探索で順に取り出します。そのたびに動作を確かめて、good か bad かを答えます。最後に、不具合が最初に入ったコミットを Git が教えてくれます。確かめる作業をスクリプトにしておけば、git bisect run で最後まで自動で進められます。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。コミットの作者(Author)の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定しました。出力が毎回同じになるよう、コミットの日時は環境変数 GIT_AUTHOR_DATE と GIT_COMMITTER_DATE で決めています。確かめる対象は、小さなシェルスクリプトです。Windows・macOS と、--term-old などで good と bad の呼び方を変える使い方は試していません。

ちょうど3000円のときに送料無料にならない不具合を例にする

例として使うのは、単価と個数から合計金額を出す total.sh です。3000円以上なら送料無料、それより安ければ送料500円を足す、という決まりにしてあります。

console
$ git log --oneline
b14f6a7 バージョンを1.1にする
4955859 お知らせを更新
38b0dbb 送料の金額を変数にまとめる
44eb671 fi の書き忘れを直す
9053b97 送料無料の判定を整理する(途中)
029ce06 READMEに税込みの注記を追加
4875160 お知らせを追加
06fd303 READMEに使い方を追加
e691ad9 3000円以上は送料無料にする
7aca488 合計を計算するスクリプトを追加
4197c2e 最初のコミット

1500円の品を2個買うとちょうど3000円なので、送料無料になって 3000 と出るのが正しい動きです。ところが、いまの main では3500円になります。タグ v1.0(e691ad9)に戻すと、3000円と正しく出ます。

console
$ ./total.sh 1500 2
3500

$ git checkout -q v1.0 && ./total.sh 1500 2; git checkout -q main
3000

v1.0 から main までのどこかで壊れたことは分かりました。v1.0 のあとには、main を含めて8つのコミットがあります。これを1つずつ戻して試す代わりに、git bisect に探させます。

good と bad を伝えて、探索を始める

git bisect start で始め、いまのコミットが bad、v1.0 が good だと伝えます。git bisect bad のようにコミットを省くと、いまのコミット(HEAD)を指したことになります。

console
$ git bisect start
status: waiting for both good and bad commits

$ git bisect bad
status: waiting for good commit(s), bad commit known

$ git bisect good v1.0
Bisecting: 3 revisions left to test after this (roughly 2 steps)
[9053b972415adeb6959b2e7e3686ef297a03f4ef] 送料無料の判定を整理する(途中)

good と bad がそろうと、Git はその間の真ん中あたりのコミットをチェックアウトします(git bisect の公式リファレンス)。Bisecting: の行は、このあと調べる残りのコミット数と、あと何回くらいで終わるかの目安です。このとき、ブランチから外れた状態(detached HEAD)になっています。

console
$ git status
HEAD detached at 9053b97
You are currently bisecting, started from branch 'main'.
  (use "git bisect reset" to get back to the original branch)

nothing to commit, working tree clean

試せないコミットは git bisect skip で飛ばす

取り出された 9053b97 で計算を試すと、スクリプトがエラーで止まりました。このコミットでは fi を書き忘れていて、そもそも動きません。

console
$ ./total.sh 1500 2
./total.sh: 8: Syntax error: end of file unexpected (expecting "fi")

これでは送料の不具合があるかどうか分からないので、good とも bad とも答えられません。こういうときは git bisect skip で飛ばします。Git が近くの別のコミットを選び直します。

console
$ git bisect skip
Bisecting: 3 revisions left to test after this (roughly 2 steps)
[487516072f4a38998cfb6e32a88aca5f1d5a0ef7] お知らせを追加

公式リファレンスによると、探しているコミットのすぐ隣のコミットを飛ばすと、飛ばしたコミットとその隣のどちらが最初の bad なのかを、Git は決められなくなります。

試すたびに good か bad を答える

あとは、取り出されたコミットで試して、結果を答えることをくり返します。3000円なら good、3500円なら bad です。

console
$ ./total.sh 1500 2
3000

$ git bisect good
Bisecting: 2 revisions left to test after this (roughly 2 steps)
[44eb671007f284a5b6149faf52c10ed8d55a2454] fi の書き忘れを直す

$ ./total.sh 1500 2
3000

$ git bisect good
Bisecting: 1 revision left to test after this (roughly 1 step)
[38b0dbb09220e849c72061c6245893c0a69e8fd2] 送料の金額を変数にまとめる

$ ./total.sh 1500 2
3500

$ git bisect bad
38b0dbb09220e849c72061c6245893c0a69e8fd2 is the first bad commit
commit 38b0dbb09220e849c72061c6245893c0a69e8fd2
Author: Neko <neko@example.com>
Date:   Wed Nov 11 11:00:00 2026 +0900

    送料の金額を変数にまとめる

 total.sh | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

is the first bad commit と出て、38b0dbb(送料の金額を変数にまとめる)が、不具合が最初に入ったコミットだと分かりました。飛ばした1つを含めて4回の確認で、8つのコミットから1つに絞り込めています。

v1.0 から main までのコミットを縦に並べた図。1番目に 9053b97 を skip、2番目に 4875160 を good、3番目に 44eb671 を good、4番目に 38b0dbb を bad と答え、38b0dbb が最初の bad になった
git bisect が取り出したコミットと、答えた順番

見つかったコミットの差分を見ると、原因が分かります。

console
$ git show 38b0dbb
commit 38b0dbb09220e849c72061c6245893c0a69e8fd2
Author: Neko <neko@example.com>
Date:   Wed Nov 11 11:00:00 2026 +0900

    送料の金額を変数にまとめる

diff --git a/total.sh b/total.sh
index f403100..df031f8 100755
--- a/total.sh
+++ b/total.sh
@@ -1,8 +1,10 @@
 #!/bin/sh
 # 使い方: ./total.sh 単価 個数
+free_from=3000
+shipping=500
 sub=$(($1 * $2))
-if [ "$sub" -ge 3000 ]; then
+if [ "$sub" -gt "$free_from" ]; then
   echo "$sub"
 else
-  echo $((sub + 500))
+  echo $((sub + shipping))
 fi

金額を変数にまとめたときに、比べ方が -ge(以上)から -gt(より大きい)に変わっていました。そのため、ちょうど3000円のときだけ送料無料にならなくなっています。

終わったら git bisect reset で元のブランチに戻る

それまでに答えた内容は、git bisect log で見られます。

console
$ git bisect log
git bisect start
# status: waiting for both good and bad commits
# bad: [b14f6a73df4ddca50ce4f46d8a322b046671e21e] バージョンを1.1にする
git bisect bad b14f6a73df4ddca50ce4f46d8a322b046671e21e
# status: waiting for good commit(s), bad commit known
# good: [e691ad91b3d44b5686d708304be8803bb7272068] 3000円以上は送料無料にする
git bisect good e691ad91b3d44b5686d708304be8803bb7272068
# skip: [9053b972415adeb6959b2e7e3686ef297a03f4ef] 送料無料の判定を整理する(途中)
git bisect skip 9053b972415adeb6959b2e7e3686ef297a03f4ef
# good: [487516072f4a38998cfb6e32a88aca5f1d5a0ef7] お知らせを追加
git bisect good 487516072f4a38998cfb6e32a88aca5f1d5a0ef7
# good: [44eb671007f284a5b6149faf52c10ed8d55a2454] fi の書き忘れを直す
git bisect good 44eb671007f284a5b6149faf52c10ed8d55a2454
# bad: [38b0dbb09220e849c72061c6245893c0a69e8fd2] 送料の金額を変数にまとめる
git bisect bad 38b0dbb09220e849c72061c6245893c0a69e8fd2
# first bad commit: [38b0dbb09220e849c72061c6245893c0a69e8fd2] 送料の金額を変数にまとめる

不具合が入ったコミットが見つかっても、作業ツリーは探索中のコミットのままです。git bisect reset で、git bisect start を実行したときのブランチに戻ります。

console
$ git bisect reset
Previous HEAD position was 38b0dbb 送料の金額を変数にまとめる
Switched to branch 'main'

$ git status -sb
## main
ポイント

探索中は、ブランチから外れた状態で古いコミットを取り出しています。不具合を直すコミットは、git bisect reset で元のブランチに戻ってから作ります。

確かめる作業をスクリプトにして、git bisect run に任せる

good か bad かをコマンドで判断できるなら、その判断をスクリプトにして git bisect run に渡せます。Git は、スクリプトの終了コードで good か bad かを決めます(git bisect の公式リファレンス)。

終了コード 扱い
0 good
125 試せないので飛ばす(skip)
1〜127(125を除く) bad
それ以外 探索を中断する

「それ以外」には 128 以上が入ります。公式リファレンスによると、exit(-1) で終わるプログラムの終了コードは 255 になるので、bad ではなく中断として扱われます。bad のときは 1 で終わるようにしておきます。

ここでは、1500円を2個で3000円と出れば good にするスクリプトを書きました。total.sh 自体がエラーで止まったときは、125 で終わって skip させます。公式リファレンスの例でも、bisect の処理とスクリプトが干渉しないよう、スクリプトはリポジトリの外に置くほうが安全だとされています。ここでも ../check.sh に置きました。

console
$ cat ../check.sh
#!/bin/sh
# 1500円を2個で、送料無料の3000円になれば good
out=$(./total.sh 1500 2) || exit 125
[ "$out" = 3000 ]

最後の行の [ "$out" = 3000 ] は、一致すれば 0、一致しなければ 1 で終わります。

console
$ [ "3000" = 3000 ]; echo "終了コード: $?"
終了コード: 0

$ [ "3500" = 3000 ]; echo "終了コード: $?"
終了コード: 1

git bisect start には、bad と good のコミットを続けて渡せます。git bisect start HEAD v1.0 は、さきほどの start、bad、good v1.0 の3つをまとめたものです。

console
$ git bisect start HEAD v1.0
Bisecting: 3 revisions left to test after this (roughly 2 steps)
[9053b972415adeb6959b2e7e3686ef297a03f4ef] 送料無料の判定を整理する(途中)

$ git bisect run ../check.sh
running '../check.sh'
./total.sh: 8: Syntax error: end of file unexpected (expecting "fi")
Bisecting: 3 revisions left to test after this (roughly 2 steps)
[487516072f4a38998cfb6e32a88aca5f1d5a0ef7] お知らせを追加
running '../check.sh'
Bisecting: 2 revisions left to test after this (roughly 2 steps)
[44eb671007f284a5b6149faf52c10ed8d55a2454] fi の書き忘れを直す
running '../check.sh'
Bisecting: 1 revision left to test after this (roughly 1 step)
[38b0dbb09220e849c72061c6245893c0a69e8fd2] 送料の金額を変数にまとめる
running '../check.sh'
38b0dbb09220e849c72061c6245893c0a69e8fd2 is the first bad commit
commit 38b0dbb09220e849c72061c6245893c0a69e8fd2
Author: Neko <neko@example.com>
Date:   Wed Nov 11 11:00:00 2026 +0900

    送料の金額を変数にまとめる

 total.sh | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
bisect found first bad commit

9053b97 ではスクリプトが125で終わったので、手で skip したときと同じく飛ばされました。そのあとは手で答えたときと同じ順にコミットを取り出し、同じ 38b0dbb にたどり着いています。git bisect run は不具合が最初に入ったコミットを見つけたところで止まるので、手で調べたときと同じく git bisect reset で元に戻します。

console
$ git bisect reset
Previous HEAD position was 38b0dbb 送料の金額を変数にまとめる
Switched to branch 'main'

$ git branch --show-current
main

​Posted by 86