Vibe Coding 用 Git Bisect 隔离回归：让历史提交替你缩小范围

线上回归出现后，团队常把最近几十个提交一次交给 AI，让它“找最可疑的变化”。模型会偏向大 diff、熟悉的反模式或刚好包含错误关键词的提交，但真正原因可能只是一个默认值、依赖锁文件或生成制品变化。Git Bisect 用已知好坏两个历史点反复二分，让可执行证据而不是代码观感决定搜索方向。

Bisect 能定位“哪个提交首次让判定从好变坏”，不能自动说明为什么，也不能替代修复验证。开始前先建立Vibe Coding 最小复现，否则每个历史点的好坏只是主观判断。

准备可判定的好点与坏点

坏点通常是当前已复现故障的提交，记录完整对象名而非短分支名。好点必须实际运行同一判定并通过，不能只依据“那周没人报告”。用 git rev-parse 固定两个 SHA，并保存当前 git status --short。工作树有用户改动时，不要启动会切换提交的操作；在独立 worktree 或干净克隆中执行，保留原现场。

同一测试在好点和坏点之间必须具有相同语义。若测试文件是后来才加入，可把独立复现脚本放在仓库外，或在每个历史点构建后从外部触发公开接口。依赖按照各提交自己的 lockfile 安装，运行时和系统依赖则固定；否则 bisect 可能定位到“今天解析了新依赖”，而不是历史代码变化。

先手动验证：坏点至少重复失败并匹配故障指纹，好点重复通过。flaky 场景需要事先定义统计判定和最大预算。例如固定种子执行多轮，只有观察到目标指纹才判坏；没有足够样本不能判好，应返回 skip。阈值按实际故障概率设计，不存在通用次数。

把判定包装成退出码契约

git bisect run 会在每个候选提交运行命令。退出码 0 表示 good，1 到 127（除 125）表示 bad，125 表示该提交无法测试而应跳过。脚本需要区分“目标回归出现”和“环境准备失败”：编译失败若属于历史不兼容，通常是 skip；不能把网络下载失败误判成产品 bad。

#!/usr/bin/env bash
set -u

./scripts/build-revision.sh || exit 125
./scripts/run-repro.sh >repro.log 2>&1
status=$?

case "$status" in
  0) exit 0 ;;   # 未出现目标故障
  42) exit 1 ;;  # 目标故障指纹
  *) exit 125 ;; # 无法可靠判定
esac

这里的 42 是复现脚本约定示例，不是 Git 规则。真实脚本还应验证错误类型、关键栈帧或最终状态，不能把任意测试失败都视为目标回归。脚本本身、运行时镜像和输入 fixture 计算哈希并随报告保存。

执行、审计并重置

在隔离工作目录运行 git bisect start BAD GOOD，先让 Git 展示待测范围，再执行判定脚本。每次结果会写入 bisect log；完成后保存 git bisect log 和首个坏提交的 git show --stat --oneline。结束必须 git bisect reset 回到原分支，随后确认状态与开始前一致。

不要让 Agent 在候选提交上顺手修代码。任何编辑都会污染下一个判定；诊断笔记放到仓库外工件。自动过程出现大量 skip 时，Git 可能只能给出一组可能提交，此时报告不确定集合，修复构建兼容或改用可测试区间，不能随便挑一个提交当答案。

合并提交、目录重组和生成文件会增加解释难度，但原则不变：bisect 输出的是首个改变判定的提交。若某提交同时包含多项修改，再对其 diff 做机制分析或在临时分支逐项反演。提交信息质量能加速这一步，可参考AI 生成 Commit Message，但信息文字不是证据。

从首坏提交走向根因

定位后检查三件事。第一，回退该提交的相关变化是否让同一复现恢复；第二，只重新引入候选变化是否让故障回来；第三，提交是否只是暴露了更早潜伏的问题，例如数据规模超过阈值。把观察与解释记入Vibe Coding 调试假设日志，不要把“first bad commit”直接写成“root cause”。

修复补丁要在坏点上通过原复现、相关回归和更广领域测试，并绑定新的 HEAD。编程 Agent 的改动验证门负责防止验证后继续编辑，Vibe Coding 修复验证与根因闭环负责确认机制与预防动作。

一次可审计的 bisect 产物包含：GOOD/BAD SHA、复现与环境哈希、每个候选的结果、skip 原因、首坏提交或不确定集合、复核实验和工作树恢复状态。Git 提供了高效搜索，AI 可以解释 diff 和维护日志；真正让定位可信的，仍是每个历史点都由同一可重放判定来决定。

延伸阅读

• Vibe Coding 最小复现
• AI 生成 Commit Message
• Vibe Coding 调试假设日志
• 编程 Agent 的改动验证门
• Vibe Coding 修复验证与根因闭环