掌握 git bisect 的二分查找算法，用最少的步骤从几百个提交中精确定位引入 Bug 的那个提交。

Bisect — 用二分法从几百个提交中找到罪魁祸首

线上出了 Bug，你知道上周还是好的，但中间有 200 个提交，逐个排查？太慢了。

git bisect 用二分查找算法，只需要 log₂(200) ≈ 8 次就能定位到引入问题的那个提交。

一、什么是 Bisect？

Bisect 的原理很简单：

1
2
3
4
5
6
7
已知：提交 A 是好的，提交 Z 是有 Bug 的

第 1 步：跳到中间提交 M，测试 → 有 Bug → Bug 在 A~M 之间
第 2 步：跳到 A~M 的中间 H，测试 → 没 Bug → Bug 在 H~M 之间
第 3 步：跳到 H~M 的中间 K，测试 → 有 Bug → Bug 在 H~K 之间
...
最终：定位到引入 Bug 的提交
提交数量逐个排查bisect
100 个最多 100 次最多 7 次
500 个最多 500 次最多 9 次
1000 个最多 1000 次最多 10 次

二、基本用法

手动二分查找

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 启动 bisect
git bisect start

# 2. 标记当前版本为"坏的"（有 Bug）
git bisect bad

# 3. 标记一个已知"好的"版本（没 Bug 的时候）
git bisect good abc1234

# Git 自动跳到中间提交
# Bisecting: 50 revisions left to test after this (roughly 6 steps)
# [def5678] feat: 添加搜索功能

测试并标记

Git 跳到中间提交后，你测试一下，告诉它结果：

1
2
3
4
5
# 如果当前版本有 Bug
git bisect bad

# 如果当前版本没 Bug
git bisect good

Git 会继续跳到下一个中间提交，重复这个过程，直到找到第一个”坏”的提交：

1
2
3
4
5
6
# abc1234 is the first bad commit
# commit abc1234
# Author: John Doe
# Date:   Mon Jun 1 10:00:00 2026
#
#     feat: 重构用户模块

结束 bisect

1
2
# 回到 bisect 之前的状态
git bisect reset

三、完整操作流程

场景：首页崩溃了，上周还是好的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# 1. 启动 bisect
git bisect start

# 2. 当前版本是坏的
git bisect bad

# 3. 找到上周没问题的提交
git log --oneline
# a1b2c3d (HEAD) feat: xxx        ← 坏的
# ...中间 200 个提交...
# x9y8z7w fix: 修了个样式          ← 上周的，确认是好的

git bisect good x9y8z7w

# Git 跳到中间：
# Bisecting: 100 revisions left (roughly 7 steps)
# [m5n6o7p] feat: 添加缓存功能

# 4. 测试当前页面... 崩溃了
git bisect bad

# Git 继续二分：
# Bisecting: 50 revisions left (roughly 6 steps)
# [q1r2s3t] refactor: 优化数据层

# 5. 测试... 正常
git bisect good

# Git 继续二分...
# ...重复 5-6 次...

# 6. 最终定位：
# abc1234 is the first bad commit
# commit abc1234
# Author: 张三
# Date:   Wed Jun 4 15:30:00 2026
#
#     refactor: 重构数据处理逻辑

# 7. 查看这个提交改了什么
git show abc1234

# 8. 结束 bisect
git bisect reset

四、自动化 bisect

如果 Bug 可以通过命令检测（如测试失败），可以让 bisect 自动运行，完全不需要手动测试。

用测试脚本自动判定

1
2
3
# 一行命令：自动 bisect，用 npm test 判定好坏
git bisect start HEAD abc1234 --
git bisect run npm test

执行过程：

1
2
3
4
5
6
7
8
Bisecting: 100 revisions left
running npm test
...测试通过... → 自动标记 good
Bisecting: 50 revisions left
running npm test
...测试失败... → 自动标记 bad
...
abc1234 is the first bad commit

用自定义脚本

1
2
3
4
5
6
7
8
9
10
11
12
# 创建检测脚本
cat > check_bug.sh << 'EOF'
#!/bin/bash
# 检查某个函数是否存在
grep -q "processPayment" src/payment.js
# 返回 0 = good（函数存在），返回 1 = bad（函数不存在）
EOF
chmod +x check_bug.sh

# 自动 bisect
git bisect start HEAD abc1234
git bisect run ./check_bug.sh

脚本返回值规则

返回值含义
0当前版本是”好的”
1-124 或 126-127当前版本是”坏的”
125当前版本无法测试（跳过）
>127中止 bisect

自动化 bisect 的优势：

  • 完全不需要人工参与
  • 判定结果客观准确
  • 适合回归测试（之前通过的测试突然失败了）

五、常用选项

用 Tag 标记好坏

1
2
3
4
# 用版本号代替 commit hash，更直观
git bisect start
git bisect bad HEAD
git bisect good v1.2.0    ← v1.2.0 是好的，当前是坏的

跳过无法测试的版本

有时候中间某个提交编译都过不了，没法测试：

1
2
# 标记为"跳过"
git bisect skip

查看 bisect 日志

1
2
# 查看 bisect 过程中每一步的判定
git bisect log

重放 bisect 日志

1
2
3
4
5
# 保存日志
git bisect log > bisect.log

# 下次用日志重放（不用重新手动标记）
git bisect replay bisect.log

六、注意事项

bisect 期间的注意事项：

  1. bisect 过程中不要手动切换分支，Git 会自动管理 HEAD
  2. 如果需要修改代码来测试，先 git stash，测试完再 git stash pop
  3. 一定记得 git bisect reset 回到正常状态
  4. “好”和”坏”的提交之间必须是连续的线性历史，中间不能有 merge 分叉

什么时候适合用 bisect？

1
2
3
4
5
6
7
8
9
10
11
提交太多，手动排查不现实？
  └── bisect ✅

Bug 可以通过命令自动检测？
  └── bisect run ✅ （全自动）

Bug 只表现在视觉上（UI 问题）？
  └── bisect 手动模式（需要人眼看）

需要跨分支定位问题？
  └── 不适合 bisect（bisect 在同一分支上工作）

总结：Bisect 速查卡

1
2
3
4
5
6
7
8
9
10
11
12
13
┌──────────────────────────────────────────────────────────┐
│                   Git Bisect 速查                          │
├────────────────┬─────────────────────────────────────────┤
│ 启动            │ git bisect start                       │
│ 标记坏的        │ git bisect bad [commit]                 │
│ 标记好的        │ git bisect good [commit]                │
│ 跳过无法测试的  │ git bisect skip                         │
│ 结束并恢复      │ git bisect reset                        │
├────────────────┼─────────────────────────────────────────┤
│ 自动 bisect     │ git bisect run <command>                │
│ 查看 bisect 日志 │ git bisect log                         │
│ 重放日志        │ git bisect replay <file>                │
└────────────────┴─────────────────────────────────────────┘