Git bisect定位故障：用已知正常和异常版本缩小范围

代码最近才出错但改动很多时，可以使用 Git bisect 缩小引入问题的提交范围。本文说明准备测试、判断结果和结束后的核查。

项目昨天正常、今天报错，但中间合入了几十次提交，逐条猜测很费时间。Git bisect 根据一个已知正常版本和一个异常版本，逐步缩小候选范围，适合结果可以稳定复现的问题。

准备可重复的判断

先保存工作区改动，记录当前分支，并确定同一测试在正常版本通过、异常版本失败。测试条件要尽量一致：数据库版本、环境变量和依赖变化都可能影响结果。无法复现的问题不适合直接把每次结果当作可靠标签。

逐步标记结果

开始 bisect 后，分别标记异常提交和较早的正常提交。Git 会检出中间版本，运行同一测试，再按真实结果标记。某个版本因为依赖损坏而无法判断，可以跳过，不要把编译失败误判成目标问题。

确认结果并退出

得到候选提交后，阅读该次改动及其上下文，在相邻版本重新验证。找到第一个异常点并不自动证明作者或某一行代码就是唯一原因。结束时使用 git bisect reset 返回原先位置，再检查工作区状态。

建议在独立工作树或测试环境操作，避免切换版本影响正在运行的网站。涉及数据库迁移或生产数据的验证，要准备隔离副本，不要让历史版本直接修改线上数据库。

参考资料

资料核对日期：2026年10月28日。

Git bisect 官方手册

Git worktree 官方手册