git blameとgit bisectで原因のコミットを探す方法を実例で解説
「この 1 行は、なぜこう書かれているんだろう」「昨日まで正しく計算できていたのに、どのコミットで壊れたのか分からない」――そんなときに使うのが git blame と git bisect です。blame は行ごとに最後に変えたコミットを表示し、bisect は「正しい版」と「壊れた版」の間を半分ずつ絞り込んで、最初に壊れたコミットを見つけます。
この記事では、20 個のコミットの途中で計算が壊れる練習用リポジトリを使い、blame の読み方と整形コミットの飛ばし方、bisect の手順と自動化を実行結果つきで説明します。実行環境は Windows 11 の Git Bash で、git --version の結果は「git version 2.49.0.windows.1」でした。オプションの意味は Git 公式ドキュメント(git-scm.com の git-blame・git-bisect)の原文で確認しています。
git log の絞り込み(-S・-G でコードの変更を探す方法など)は「Gitの履歴を調べる方法」で説明しています。ほかの Git コマンドを目的から探すなら「Gitコマンド検索」が便利です。
練習用リポジトリ「shop」
税込み価格を計算する calc.py と、送料を計算する shipping.py を持つ架空のリポジトリです。作者は Sato Hanako と Suzuki Taro、日付は 2026 年 10 月に固定しました。git log --oneline の結果です(新しいものが上)。
5b3b71d バージョン 1.1
d25caa8 引数がないときのメッセージを追加
4786519 ポイント計算に説明を追加
5879162 割引率の上限を50%にする
42264e6 README の使い方を更新
dd479b3 テストを追加
d0d5a9a 送料を600円に変更
7e143a8 税額を変数に分ける
57212e4 ポイント計算を追加
58f2815 config.py を追加
1e9cfeb 税率を config.py に分ける(途中)
de2a21d README に割引の説明を追加
56e4571 割引の関数を追加
48e71cf 整形ツールで整形
8c81607 送料の計算を shipping.py に移す
26fd7af 送料無料の基準を変数にする
ffab4c2 税込み計算に説明を追加
a24375c 合計を出す関数を追加
8ae4d24 README に使い方を追加
0552fd4 送料の計算を追加
2ebff97 税込み計算を追加
cf3a1fd 最初のコミット
2ebff97 に v1.0 のタグがあり、その後に 20 個のコミットがあります。v1.0 では py calc.py 1000 が 1100(1,000 円の税込み)を返していたのに、今の main では 1010 を返します。この不具合を blame と bisect の両方から追いかけます。py は Windows の Python ランチャーで、Mac や Linux では python3 に読み替えてください。
git blame:行ごとに「最後に変えたコミット」を見る
出力の読み方
-L :関数名 を付けると、その関数の範囲だけを表示できます。
git blame -L :tax_included calc.py
2ebff971 (Sato Hanako 2026-10-02 10:00:00 +0900 5) def tax_included(price):
ffab4c20 (Sato Hanako 2026-10-06 10:00:00 +0900 6) # 1円未満は切り捨て
7e143a84 (Sato Hanako 2026-10-15 10:00:00 +0900 7) tax = price * TAX_RATE // 1000
7e143a84 (Sato Hanako 2026-10-15 10:00:00 +0900 8) return price + tax
2ebff971 (Sato Hanako 2026-10-02 10:00:00 +0900 9)
2ebff971 (Sato Hanako 2026-10-02 10:00:00 +0900 10)
左から「その行を最後に変えたコミット ID」「作者」「日時」「今のファイルでの行番号」「行の中身」です。7 行目の // 1000 が怪しく見えます(10% の税なら 100 で割るはず)。ここから先は、日時を日付だけにする --date=short を付けて表示します。
blame は「犯人探し」ではなく経緯を知る道具
blame は英語で「責める」という意味ですが、使い道は誰のせいかを決めることではありません。表示されるのは最後にその行に触れた人で、整形やファイルの移動をしただけの人が出ることもよくあります。知りたいのは「なぜこの行がこうなったのか」で、それはコミットのメッセージと変更の中身に書かれています。git show 7e143a8 で中身を見ると、メッセージは「税額を変数に分ける」で、差分は次の部分でした。
- return price * (100 + TAX_RATE) // 100
+ tax = price * TAX_RATE // 1000
+ return price + tax
書き直しのときに、100 で割るべきところを 1000 と書いてしまったことが分かります。作者に聞くなら「なぜ間違えたのか」ではなく「このとき何をしたかったのか」を確認すると、直し方の相談がしやすくなります。
さらに前をたどる:コミット^ を指定する
7e143a8 の「1 つ前(親)」の時点で blame すると、書き換えられる前の行の由来が分かります。コミットの後ろの ^ は「親のコミット」という意味です。
git blame --date=short -L :tax_included 7e143a8^ -- calc.py
2ebff971 (Sato Hanako 2026-10-02 5) def tax_included(price):
ffab4c20 (Sato Hanako 2026-10-06 6) # 1円未満は切り捨て
48e71cfc (Suzuki Taro 2026-10-09 7) return price * (100 + TAX_RATE) // 100
2ebff971 (Sato Hanako 2026-10-02 8)
2ebff971 (Sato Hanako 2026-10-02 9)
書き換え前の 7 行目は 48e71cfc(整形ツールで整形)が最後に触れていました。整形は中身を変えていないので、本当の由来はその前です。飛ばし方はこのあと説明します。
^ が付いた ID:境界コミット
README.md を blame すると、最初の 3 行の ID の前に「^」が付きました。
^cf3a1fd (Sato Hanako 2026-10-01 1) # shop
「^」は境界(boundary)コミットの印で、「blame がこれより前はたどらなかった」という意味です。cf3a1fd は最初のコミット(親がない)なので、そこで探索が終わっています。--root を付けると ^ が付かなくなりました。git blame v1.0.. -- calc.py のように範囲を区切ったときも、範囲の外の行に ^ が付きます。
-w:空白だけの変更を飛ばす
-w は空白の違いを無視して行の由来を探します。整形で変わったのが price*(100+TAX_RATE)//100 → price * (100 + TAX_RATE) // 100 という空白だけだったので、さきほどのコマンドに -w を付けると、7 行目は最初に書いた 2ebff971 になりました。
git blame -w --date=short -L :tax_included 7e143a8^ -- calc.py
2ebff971 (Sato Hanako 2026-10-02 7) return price * (100 + TAX_RATE) // 100
(7 行目だけ抜き出しています。)ただし、-w が飛ばせるのは空白だけです。同じ整形のコミットでは '__main__' を "__main__" に変え、空行も 1 行足しています。今の calc.py の 26 行目(if __name__ == "__main__":)と 28 行目(空行)は、-w を付けても 48e71cfc のままでした。
整形だけのコミットを飛ばす:.git-blame-ignore-revs
フォーマッター(コードの見た目を自動で整えるツール)を全体にかけたコミットは、blame の結果を「整形」だらけにします。そこで、飛ばしたいコミットの ID を書いたファイルを作り、--ignore-revs-file で渡します。ファイル名は .git-blame-ignore-revs がよく使われます。
# 整形ツールで整形(中身は変えていない)
48e71cfcd889d61676de34a8b5092446502b041f
1 行に 1 つ、省略しない 40 文字の ID を書きます(git rev-parse 48e71cf で表示できます)。# から始まる行はコメントです。
git blame --ignore-revs-file .git-blame-ignore-revs --date=short -L 26,28 calc.py
2ebff971 (Sato Hanako 2026-10-02 26) if __name__ == "__main__":
2ebff971 (Sato Hanako 2026-10-02 27) import sys
48e71cfc (Suzuki Taro 2026-10-09 28)
26 行目は、引用符を変えた整形を飛ばして 2ebff971 になりました。公式ドキュメントによると、無視したコミットで変わった行は「その行、または近くの行を前に変えたコミット」のものとして表示されます。28 行目は整形で新しく足された空行なので、前の持ち主が見つからず 48e71cfc のままです。
設定 blame.markIgnoredLines と blame.markUnblamableLines を true にして同じコマンドを実行すると(git -c blame.markIgnoredLines=true -c blame.markUnblamableLines=true blame …)、26 行目は「?2ebff97」、28 行目は「*48e71cf」と表示されました。「?」は別のコミットに付け替えた行、「*」は付け替え先が見つからなかった行の印です。
毎回オプションを書くのが面倒なら、そのリポジトリの設定に登録します(--global を付けないので、このリポジトリだけに効きます)。
git config blame.ignoreRevsFile .git-blame-ignore-revs
このあとは git blame calc.py だけで整形のコミットが飛ばされました。一時的に無視をやめたいときは --ignore-revs-file ""(空のファイル名)を付けると、リストが空になります。
.git-blame-ignore-revs をコミットしてリポジトリの一番上のフォルダーに置くと、チームで同じリストを使えます。GitHub の blame 画面もこのファイルを読み、書かれたコミットを飛ばします(GitHub Docs の「Viewing and understanding files」で確認)。ただし blame.ignoreRevsFile の設定は各自のリポジトリに入れる必要があります。
-C:ほかのファイルから移した行の元をたどる
shipping.py は、8c81607 で calc.py から送料の関数を切り出したファイルです。普通に blame すると、最後の行(d0d5a9a0 の送料変更)以外はすべて 8c816078(移したコミット)になりました。-C を付けると、同じコミットで変わったほかのファイルから移した・コピーした行を探し、元のファイル名の列が増えます。
git blame -C --date=short shipping.py
8c816078 shipping.py (Sato Hanako 2026-10-08 1) FREE_LINE = 5000
8c816078 shipping.py (Sato Hanako 2026-10-08 2)
8c816078 shipping.py (Sato Hanako 2026-10-08 3)
0552fd45 calc.py (Suzuki Taro 2026-10-03 4) def shipping(total):
0552fd45 calc.py (Suzuki Taro 2026-10-03 5) # 5000円以上は送料無料
26fd7afd calc.py (Suzuki Taro 2026-10-07 6) if total >= FREE_LINE:
0552fd45 calc.py (Suzuki Taro 2026-10-03 7) return 0
d0d5a9a0 shipping.py (Suzuki Taro 2026-10-16 8) return 600
関数の中身は、calc.py で書かれたコミットまでさかのぼれました。1 行目の FREE_LINE = 5000 も calc.py から移した行ですが、8c816078 のままです。公式ドキュメントによると、-C は英数字が 40 文字以上まとまって動いたときだけ「移動」とみなすためです(-C30 のように数を変えられます)。同じファイルの中で行を入れ替えただけなら -M を使います。
blame が教えるのは「最後に触れたコミット」だけです。「どのコミットで動きが壊れたか」を確実に知りたいときは、次の git bisect を使います。
git bisect:壊れたコミットを二分探索で探す
二分探索のしくみ
git bisect に「正しく動いていたコミット(good)」と「壊れているコミット(bad)」を教えると、その間のコミットを二分探索(真ん中を調べて、候補を半分ずつに減らす方法)で取り出します。あなたはそのコミットで動作を確かめ、good か bad かを答えるだけです。
v1.0 と main の間の 20 個なら、20 → 10 → 5 → 3 → 2 → 1 と半分にしていくので、多くても 5 回ほどで見つかります(2 の 5 乗=32 が 20 以上のため)。同じ考え方で、100 個なら 7 回、1,000 個でも 10 回ほどです。
下の図は、このあと実際に手で進めたときの流れです。0 が v1.0、20 が main で、番号は v1.0 から数えた順番です(13 が 7e143a8「税額を変数に分ける」)。

始める前に確かめること
始める前に、git status でコミットしていない変更がないことを確かめます(bisect は過去のコミットに切り替えながら進むので、変更が残っていると始められません。残したい変更は git stash で退避します)。あわせて、確実に正しかったコミット(今回は v1.0)と、判定の方法(py calc.py 1000 が 1100 なら good、1010 なら bad)を決めておきます。
手で進める:start → bad → good
bisect を始め、今いる main が壊れていること(bad)、v1.0 が正しかったこと(good)を伝えます。
git bisect start
git bisect bad
git bisect good v1.0
Bisecting: 9 revisions left to test after this (roughly 3 steps)
[1e9cfeb806c55a353b4980b9f7dee283f7aee543] 税率を config.py に分ける(途中)
真ん中あたりの 1e9cfeb(図の 10)に切り替わりました。「この後に確かめる候補は 9 個、あと 3 回ほど」という意味です。ここで py calc.py 1000 を実行して動作を確かめます。
確かめられないコミットは skip
結果は「ModuleNotFoundError: No module named ‘config’」というエラーでした。config.py に分ける途中のコミットで、config.py がまだないからです。こういうテストできないコミットは、good でも bad でもなく skip で飛ばします。
git bisect skip
Bisecting: 9 revisions left to test after this (roughly 3 steps)
[58791629bc14e47ffde3f0df2d3180644014dac9] 割引率の上限を50%にする
切り替わった 5879162(図の 17)では 1010 だったので git bisect bad と答えます。このあとも同じように確かめては答えていきました。
| 回 | 切り替わったコミット | 結果 | 答え |
|---|---|---|---|
| 2 回目 | 5879162 割引率の上限を50%にする(17) | 1010 | bad |
| 3 回目 | 56e4571 割引の関数を追加(8) | 1100 | good |
| 4 回目 | 57212e4 ポイント計算を追加(12) | 1100 | good |
| 5 回目 | d0d5a9a 送料を600円に変更(14) | 1010 | bad |
| 6 回目 | 7e143a8 税額を変数に分ける(13) | 1010 | bad |
最後の git bisect bad で、次のように表示されました。
7e143a84ed4f2fe1ef95bbe500d4dbc33cb982dc is the first bad commit
commit 7e143a84ed4f2fe1ef95bbe500d4dbc33cb982dc
Author: Sato Hanako <sato@example.com>
Date: Thu Oct 15 10:00:00 2026 +0900
税額を変数に分ける
calc.py | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
「is the first bad commit」が最初に壊れたコミットで、blame で怪しいと思った 7e143a8 と一致しました。skip を 1 回はさんで、確かめた回数は 5 回です。
skip には注意点があります。公式ドキュメントには「探しているコミットのすぐ隣を skip すると、どれが最初の bad かを Git が決められなくなる」とあります。試しに git bisect start 7e143a8 58f2815(bad、good の順)で始め、間の 57212e4 を skip すると、「There are only ‘skip’ped commits left to test.」「The first bad commit could be any of:」に続いて 57212e4 と 7e143a8 の 2 つの ID が表示され、「We cannot bisect more!」で止まりました。残りは git show で中身を読んで見分けます。
終わったら必ず reset
調べ終わったら、bisect を終了して元のブランチに戻ります。
git bisect reset
「Previous HEAD position was 7e143a8 税額を変数に分ける」「Switched to branch ‘main’」と表示され、main に戻りました。reset するまでは、過去のコミットを取り出した状態(detached HEAD)のままで、git status には「You are currently bisecting, started from branch ‘main’.」と表示されます。この状態で作業を始めないよう、bisect の最後は必ず reset します。
git bisect run でテストを自動で回す
good か bad かをコマンドで判定できるなら、git bisect run に任せられます。判定用のスクリプト check.py を、リポジトリの外(shop フォルダーの 1 つ上)に作りました。
import sys
sys.path.insert(0, ".") # 今いるフォルダー(リポジトリ)の calc.py を読む
try:
from calc import tax_included
except ImportError:
sys.exit(125) # このコミットは動かせないので飛ばす
if tax_included(1000) == 1100:
sys.exit(0) # good
else:
sys.exit(1) # bad
git bisect run は、スクリプトの終了コード(プログラムが終わるときに返す数)で答えを決めます。公式ドキュメントの決まりは、0 が good、1〜127(125 を除く)が bad、125 が「テストできないので skip」、それ以外は bisect の中止です。git bisect start には「bad、good」の順でコミットを渡せるので、2 つのコマンドで済みます。
git bisect start main v1.0
git bisect run py ../check.py
running 'py' '../check.py'
Bisecting: 9 revisions left to test after this (roughly 3 steps)
[58791629bc14e47ffde3f0df2d3180644014dac9] 割引率の上限を50%にする
running 'py' '../check.py'
(中略)
7e143a84ed4f2fe1ef95bbe500d4dbc33cb982dc is the first bad commit
(コミットの情報は手で探したときと同じなので省略)
bisect found first bad commit
1e9cfeb では import に失敗して 125 が返り、自動で skip されました。そのあとは手で進めたときと同じ順に進み、同じ 7e143a8 にたどり着きました。終わったら git bisect reset を忘れずに実行します。
実際のプロジェクトでは、テストのコマンドをそのまま渡すこともあります(Python のテストは「Pythonのテスト入門」を参照)。ただし、後の「よくある間違い」のとおり、テストのファイルが古いコミットにもあるかに注意してください。
原因のファイルが分かっているなら、git bisect start main v1.0 -- calc.py config.py のように -- のあとにファイル名を書くと、そのファイルを変えたコミットだけが候補になります。この形では候補が減り、4 回の確認で 7e143a8 が見つかりました。
なお、「600 という文字がいつ入ったか」のようにコードの文字で探せるものは、git log -S のほうが速く見つかります(「Gitの履歴を調べる方法」を参照)。bisect は、文字では探せない「動き」の変化を探すのに向いています。
bisect log と replay で答え間違いをやり直す
手で進めていると、good と bad を答え間違えることがあります。試しに、さきほどと同じ手順の途中で、本当は bad の 5879162 に good と答えると、間違った範囲に進んでしまいました。ここまでの答えは git bisect log で確認でき、ファイルに保存できます。
git bisect log > ../bisect.txt
保存したファイルは 1 行に 1 つの答え(git bisect good 58791629… など)が並び、「#」から始まる行はメモです。間違えた最後の 2 行(# good: [5879162…] と git bisect good 5879162…)をエディターで消して保存し、git bisect reset のあと replay で読み込み直します。
git bisect replay ../bisect.txt
status: waiting for both good and bad commits
Bisecting: 9 revisions left to test after this (roughly 3 steps)
[58791629bc14e47ffde3f0df2d3180644014dac9] 割引率の上限を50%にする
間違える直前の 5879162 に戻ったので、今度は正しく bad と答えて続けます。
よくある間違い・トラブル
リポジトリの中のテストで bisect run して、違うコミットが出た
test_calc.py は途中の dd479b3(テストを追加)で入ったファイルです。それなのに git bisect run py test_calc.py を実行すると、古いコミットでは「can’t open file」となって Python が終了コード 2 を返し、bad と扱われました。最後に表示されたのは「0552fd4… is the first bad commit」(送料の計算を追加)というまったく関係ないコミットでした。テストやスクリプトは check.py のようにリポジトリの外に置きます。公式ドキュメントも、スクリプトはリポジトリの外のほうが安全だと書いています。
変更が残っていて bisect が始まらない
calc.py にコミットしていない変更がある状態で git bisect start main v1.0 を実行すると、「error: Your local changes to the following files would be overwritten by checkout:」と表示され、「Aborting」で止まりました。このとき bisect は始まっていない状態に戻り、git bisect log は「We are not bisecting.」と表示しました。先にコミットするか stash で退避してから、もう一度 start します。
ignore-revs のファイルで blame が止まる
48e71cf のような短い ID だけを書くと「fatal: invalid object name: 48e71cf」、設定 blame.ignoreRevsFile に書いたファイルがないと「fatal: could not open object name list: ファイル名」と表示されて、blame が止まりました。ID は 40 文字で書き、ファイルはコミットしておきます。
よくある質問
マージの多い履歴でも bisect は使えますか?
使えます。公式ドキュメントには git bisect start --first-parent というオプションがあり、マージコミットでは 1 つ目の親だけをたどるので、「マージしたブランチの途中のコミットは動かないが、マージ自体は問題ない」ときの空振りを減らせると説明されています(この記事のリポジトリは一直線の履歴なので試していません)。
まとめ
- blame は「最後に触れたコミット」を見て経緯を読む道具。整形は
-w・.git-blame-ignore-revs、移動は-Cで飛ばす - bisect は start → bad → good(テストできなければ skip)で二分探索し、終わったら必ず reset。判定をスクリプトにできるなら
git bisect run
関連する記事・ツール
- Gitコマンド検索
- Gitの履歴を調べる方法:git logの絞り込み・blame・bisectを実例で解説
- Gitで取り消す方法まとめ:restore・reset・revertの使い分けを解説
- Gitのブランチの使い方:作成・切り替え・マージ・削除を実行結果つきで解説
- git stashの使い方:作業中の変更を一時退避して戻す方法を実行結果つきで解説
- Gitフック入門|pre-commitで自動チェックする書き方とWindowsでの注意点
- Pythonのテスト入門|unittestとpytestの書き方・実行方法を実例で比較