git bisect二分查找Bug的方法【攻略】

git bisect 不是自动找 Bug 的魔法，它只负责高效缩范围；真正决定结果对错的，是你标得准不准、测得稳不稳、跳得对不对。

话说回来，很多开发者对 git bisect 抱有一种不切实际的幻想，以为它能自动定位问题。其实不然，它的核心价值在于“高效缩小嫌疑范围”。至于最终找到的是不是真凶，完全取决于三个操作环节：标记的准确性、测试的稳定性，以及遇到障碍时“跳过”操作的合理性。

怎么启动并设置 good/bad 范围才不会翻车

启动命令本身很简单，但翻车往往始于第一步——标记错了 good 或 bad。这会导致整个二分过程精准地收敛到一个错误的提交上。常见的坑有哪些呢？

• 把“没触发 Bug”误判为“逻辑正确”。比如某个被标记为 good 的提交，只是恰好没执行到出问题的代码分支，隐患其实早已埋下。
• 使用了一个不稳定的标签（例如 v1.2.0-rc2）作为 good 基准，结果这个版本本身就已经包含了未合入的修复补丁。
• 没有确认当前的 HEAD 确实存在 Bug。有时候问题可能出在本地环境：依赖没装、配置遗漏，或者是缓存没清理干净。

那么，如何安全起步？经验表明，遵循以下步骤更稳妥：

• 务必先手动复现 Bug，确保问题真实存在，再执行 git bisect start。
• 使用 git bisect bad 标记当前版本后，紧接着就用完整的标签名指定一个已知的好版本，例如 git bisect good v1.0.0（避免只写 v1 可能产生的歧义）。
• 如果对哪个旧版本绝对没问题心存疑虑，不妨往前多试一两个标签。比如从 v0.9.0 开始标记 good，再与 v1.0.0 的情况进行交叉验证。

git bisect run 自动化时脚本必须满足什么条件

git bisect run 是提升效率的关键，但它完全依赖脚本的退出码做判断：0 代表 good，非 0 则代表 bad。脚本但凡有点“小心思”，就可能误导 Git。

• 脚本内部不能包含任何交互操作，比如 read、启动 vim，或者在 echo 后等待用户输入。
• 不能依赖那些尚未通过 git add 提交的本地修改，因为 bisect 在切换提交时，这些改动会丢失。
• 任何失败——无论是编译失败、模块导入报错，还是 HTTP 请求超时——都必须确保脚本返回非 0 的退出码（例如 exit 1）。否则，Git 会乐观地将其视为 good。
• 一个实用的建议是：在脚本开头加上 set -e。这能保证其中任何一条命令执行失败，脚本就会立即中断并返回非零状态，省去很多手动判断的麻烦。

来看一个最小可用的自动化脚本示例（保存为 test-bug.sh）：

#!/bin/sh
set -e
npm ci --silent
npm run build
python -m pytest tests/test_auth.py -v --tb=short

然后运行：git bisect run ./test-bug.sh，接下来就交给 Git 自动推进了。

遇到编译失败或 merge 提交该怎么跳过

二分路径上的提交，并非每一个都能顺利通过测试。Git 默认会卡住，这时候就需要手动干预：

• 遇到编译失败、缺少依赖或配置缺失的情况，直接使用 git bisect skip。这个命令可以连续执行，跳过多个无法测试的提交。
• 遇到合并提交（可以用 git show --pretty=%p -q HEAD 查看，输出两个哈希值代表是合并提交），Git 默认会随机选择一条父路径继续，这可能导致绕远路。如果项目采用的是主干开发模式，更高效的做法是在启动时就加上 --first-parent 选项：git bisect start --first-parent。
• 跳过太多次，导致剩余的可疑提交范围变得零散？可以使用 git bisect visualize 来图形化查看当前的候选集。如果情况不理想，必要时就用 git bisect reset 推倒重来，并显式指定一个新的范围：git bisect start <已知good的哈希> <已知bad的哈希>。

中途想暂停或恢复，BISECT_LOG 怎么用

直接使用 git bisect reset 会清除所有二分状态，但操作日志其实被完整保留了下来。所有你输入过的 git bisect good 或 git bisect bad 命令，都记录在 .git/BISECT_LOG 文件里。

• 想要备份当前进度？执行 git bisect log > bisect-backup.txt 即可。
• 想快速定位到最后一次标记为 bad 的提交？试试这个命令组合：tail -n 1 .git/BISECT_LOG | grep 'bad '。
• 需要恢复进度时，切记不要直接 git bisect start。正确做法是：先从日志或备份文件中找出最近一次确认的 good 和 bad 提交哈希，然后显式地启动二分：git bisect start 。

最后，有几个细节真正决定了排查效率，却容易被忽略：处理合并提交时对父提交链的选择、跳过大量提交后剩余范围是否依然逻辑连贯，以及自动化脚本中那些没有受到 set -e 保护的静默失败。这些地方平时不出问题，一旦出问题，很可能就意味着半天功夫白费了。这才是关键所在。