【Git】bisectでバグコミット特定完全ガイド｜log₂N回の二分探索・bisect run自動化・–first-parent・path絞り込み・CI統合まで

$ git bisect bad
Bisecting: 512 revisions left to test after this (roughly 9 steps)
[a1b2c3d] feat: 新機能追加

# "roughly 9 steps" が残りの最大テスト回数
# → あと9回テストで犯人が決まる

# ① 開始（現在のHEADを基点に）
git bisect start

# ② 現状を"bad"（バグあり）としてマーク
git bisect bad

# ③ 正常だった時点を"good"として指定
git bisect good v1.2.0        # タグ指定
git bisect good HEAD~200      # 相対指定
git bisect good 3a8b2c1       # SHA指定

# Gitが自動で中間コミットへチェックアウト
# → ここでアプリ起動／テストして再現確認

# ④ 再現したら bad、再現しなければ good
git bisect bad       # or
git bisect good

# Gitがまた次の中間点へ移動 → 繰り返し
# …
# a1b2c3d is the first bad commit  ← 犯人判明

# ⑤ 終了（HEADを元の位置に戻す）
git bisect reset

# 1コマンドで開始（bad=現在、good=v1.2.0）
git bisect start HEAD v1.2.0

# Git 2.29+ の新構文（より明示的）
git bisect start --term-new=broken --term-old=working HEAD v1.2.0

#!/usr/bin/env bash
# scripts/bisect_test.sh
set -u

# ① 依存インストール（失敗したらskip）
if ! npm ci --silent; then
  exit 125   # このコミットでは判定不可
fi

# ② ビルド（失敗もskip）
if ! npm run build --silent; then
  exit 125
fi

# ③ 再現テスト（失敗＝bad、成功＝good）
npm test -- --testNamePattern="bug_X" --silent
# npm testの終了コードをそのまま返す

chmod +x scripts/bisect_test.sh

git bisect start
git bisect bad
git bisect good v1.2.0
git bisect run ./scripts/bisect_test.sh

# 出力例
# running ./scripts/bisect_test.sh
# Bisecting: 250 revisions left to test...
# ...
# a1b2c3d4e5f6... is the first bad commit
# bisect run success

# 手動でskip
git bisect skip

# skip範囲を指定
git bisect skip HEAD~5..HEAD

# 自動スクリプトでskipを返す
exit 125   # → Gitが自動で別のコミットを試す

# skipが多くて範囲確定する
$ git bisect bad
The first bad commit could be any of:
a1b2c3d feat: 新機能
d4e5f6c refactor: ユーティリティ整理
9a8b7c6 fix: typo
We cannot bisect more!

# これら3つの中に犯人がいる → 手動で1つずつ確認
git show a1b2c3d    # 差分チェック
git show d4e5f6c
git show 9a8b7c6

# Git 2.29+ で使えるfirst-parentモード
git bisect start --first-parent
git bisect bad HEAD
git bisect good v1.2.0

# → mainのマージコミット系列だけを二分探索
# → PR単位で犯人が判明
# → 該当PRが分かれば、そのPR内で再度bisectを回せる

# Step1: first-parentで犯人PRを特定
git bisect start --first-parent HEAD v1.2.0
git bisect run ./scripts/bisect_test.sh
# → mergeコミット M123 が犯人と判明

# Step2: PR内部で通常のbisect
git bisect reset
git bisect start
git bisect bad M123
git bisect good M123^     # マージ直前
git bisect run ./scripts/bisect_test.sh
# → PRのどのコミットでバグが入ったかまで特定

# 特定ディレクトリのみ
git bisect start -- src/image-processor/
git bisect bad
git bisect good v1.2.0

# 複数path指定
git bisect start -- src/image-processor/ src/filters/

# 特定ファイルのみ（精密）
git bisect start -- src/image-processor/core.js

# 除外指定（例：テスト以外のコミットに絞る）
git bisect start -- . ":(exclude)*.test.js"

# 現在までのbisect操作を表示
git bisect log
# git bisect start
# git bisect bad HEAD
# git bisect good v1.2.0
# git bisect bad a1b2c3d
# git bisect good d4e5f6c

# ファイルに保存（共有用）
git bisect log > bisect-session.log

# 後日または他メンバーが再現
git bisect replay bisect-session.log
# → 記録された全操作が自動で再生される
# → 同じ地点からbisect継続可能

# 保存
git bisect log > bisect-session.log

# エディタで該当行を編集（bad → good など）
nano bisect-session.log

# 一旦abort
git bisect reset

# 修正した内容でやり直し
git bisect replay bisect-session.log

# bisect用の別ディレクトリを切り出し
git worktree add ../repo-bisect HEAD
cd ../repo-bisect

# ここでbisect（本体リポは自由に作業可）
git bisect start
git bisect bad
git bisect good v1.2.0
git bisect run ../main-repo/scripts/bisect_test.sh

# 終了
git bisect reset
cd ../main-repo
git worktree remove ../repo-bisect

#!/usr/bin/env bash
# scripts/bisect_perf.sh
set -u

# ビルド（失敗はskip）
npm ci --silent || exit 125
npm run build --silent || exit 125

# ベンチマーク実行（結果をmsで取得）
TIME_MS=$(node scripts/bench.js | awk '/response_time/ {print $2}')

# 閾値判定：100ms以上ならbad（遅延）
THRESHOLD=100
if (( $(echo "$TIME_MS > $THRESHOLD" | bc -l) )); then
  echo "Slow: ${TIME_MS}ms > ${THRESHOLD}ms"
  exit 1    # bad
else
  echo "OK: ${TIME_MS}ms"
  exit 0    # good
fi

git bisect start --term-new=slow --term-old=fast
git bisect slow         # 現在は遅い
git bisect fast v1.2.0  # v1.2.0では速かった
git bisect run ./scripts/bisect_perf.sh

# "slow is the first slow commit" と結果が出る

#!/usr/bin/env bash
# scripts/bisect_docker.sh
set -u

IMAGE="myapp-bisect:$(git rev-parse HEAD)"

# 各コミットでイメージビルド（失敗はskip）
docker build -t "$IMAGE" . || exit 125

# コンテナでテスト実行
if docker run --rm "$IMAGE" npm test; then
  exit 0      # good
else
  exit 1      # bad
fi

#!/usr/bin/env bash
# 例：DB/Redisが必要なテスト
docker compose up -d --build || exit 125
trap "docker compose down" EXIT

sleep 10    # 起動待ち（ヘルスチェック推奨）

docker compose exec -T app npm test
RESULT=$?

exit $RESULT

#!/usr/bin/env bash
# bisect_flaky.sh: 3回テストして2回以上pass→good
set -u

npm ci --silent || exit 125

PASS_COUNT=0
for i in 1 2 3; do
  if npm test --silent; then
    PASS_COUNT=$((PASS_COUNT + 1))
  fi
done

# 2回以上成功でgood
if [ $PASS_COUNT -ge 2 ]; then
  exit 0
else
  exit 1
fi

name: Auto Bisect

on:
  issue_comment:
    types: [created]

jobs:
  bisect:
    if: contains(github.event.comment.body, '/bisect')
    runs-on: ubuntu-latest
    timeout-minutes: 120
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0          # 全履歴が必要

      - name: Parse comment
        id: parse
        run: |
          echo "bad=$(echo "${{ github.event.comment.body }}" | grep -oP 'bad=\K\S+')" >> $GITHUB_OUTPUT
          echo "good=$(echo "${{ github.event.comment.body }}" | grep -oP 'good=\K\S+')" >> $GITHUB_OUTPUT

      - name: Run bisect
        run: |
          git bisect start
          git bisect bad ${{ steps.parse.outputs.bad }}
          git bisect good ${{ steps.parse.outputs.good }}
          git bisect run ./scripts/bisect_test.sh | tee bisect-result.txt

      - name: Report result
        if: always()
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require("fs");
            const result = fs.readFileSync("bisect-result.txt", "utf8");
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: "```\n" + result + "\n```"
            });

# Issueにコメント
/bisect bad=HEAD good=v1.2.0

# → Actionsが起動し、数十分後に結果コメント
# → 'a1b2c3d is the first bad commit'

# エラー例
error: Your local changes to the following files would be overwritten by checkout:
  src/app.js

# 対処：stash → bisect → stash pop
git stash -u
git bisect start ...
# ... bisect終了後
git bisect reset
git stash pop

# 任意のタイミングで中断
git bisect reset
# → 開始前のHEADに戻る

# 特定コミットへresetして終了したい場合
git bisect reset HEAD@{1}

# 現在の操作を保存
git bisect log > session.log

# session.logをエディタで開き、誤ったgood↔badを修正

# リセットして再生
git bisect reset
git bisect replay session.log