git bisect start启动前必须确认三件事：明确的“坏”提交（如head）、明确的“好”提交（如已验证的tag或hash）、可重复验证的判断标准（自动化脚本或清晰手动步骤），缺一不可。
git bisect start 启动前必须确认的三件事
没想清楚就敲 git bisect start，大概率中途卡住或得出错误结论。它不关心你多着急，只认两个硬条件：一个明确的“坏”状态、一个明确的“好”状态、一个可重复验证的判断标准。
常见错误现象：git bisect 切到某个提交后，测试通过但页面白屏；或者测试失败但实际功能正常——这说明你的“好/坏”判定逻辑不稳定。
- “坏”提交必须是当前 HEAD 或已知最近一次出问题的 commit（比如
git bisect bad HEAD） - “好”提交不能靠印象，得是真实跑过验证的（比如 tag
v2.4.0、分支release/2.3或具体 hasha1b2c3d） - 验证动作必须能稳定复现：用自动化脚本最好（
npm test、python -m pytest tests/login_test.py），手动点页面至少要写清步骤（如“打开 /login → 输入 test@example.com → 点击登录 → 检查是否跳转至 /dashboard”）
git bisect run 自动化时脚本返回值怎么设
git bisect run 不是帮你执行命令，而是靠命令的退出码（exit code）做判断：返回 0 表示“good”，非 0（通常是 1）表示“bad”。脚本里任何一步失败都会让整个命令退出非零，所以必须显式控制。
容易踩的坑：脚本里用了 set -e 但没处理临时文件清理，导致某次运行因 rm: cannot remove 'tmp.log': No such file 失败，git bisect 就把它当“bad”了——其实只是清理报错，功能完全正常。
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- Python 脚本结尾加
sys.exit(0)表示 good，sys.exit(1)表示 bad - Bash 脚本用
exit 0/exit 1，别依赖最后一条命令的返回值 - 如果测试本身可能偶发失败（比如网络请求超时），在脚本里加重试逻辑，避免把抖动当成 Bug
- 路径和依赖要隔离：脚本里别直接用全局
node_modules，先npm ci --no-save确保环境干净
遇到无法编译/启动的中间提交怎么办
二分过程中 Git 可能切到一个根本跑不起来的提交（比如删了关键配置、改了构建工具版本但没提交配套改动），这时你不能硬测，得跳过它。
直接执行 git bisect skip 是最常用解法，但它有副作用：跳得越多，最终结果越可能不准，尤其当连续几个提交都跳过时，git bisect 会警告 “roughly 5 steps left”，实际可能只剩模糊范围。
- 优先尝试修复：看下
git show --stat，如果是少了个配置文件，手动补上再测 - 跳过单个提交用
git bisect skip HEAD，跳过一段范围用git bisect skip abc123^..def456 - 如果跳过太多，考虑换更窄的“好/坏”边界——比如原先是
v1.0.0到HEAD，现在改用v2.1.0到HEAD，哪怕多试几次也比结果飘忽强 - 别在 bisect 会话中
git commit或git merge，游离 HEAD 下的提交不会自动关联到任何分支，极易丢失
定位完成后 git bisect reset 容易被忽略的细节
很多人看到 abc123def is the first bad commit 就以为结束了，直接关终端。但此时你还在 bisect 游离状态，git status 显示 “HEAD detached at abc123def”，下次 checkout 分支可能意外带上这个脏状态。
最稳妥的做法不是只敲 git bisect reset，而是明确指定回哪里：
- 回到原始分支（比如启动前在
main）：git bisect reset main - 如果记不清原分支名，先
git bisect log看第一行 “git bisect start [...]” 里有没有记录起始点 - reset 后建议立刻
git status确认是否回到预期状态，避免后续操作污染工作区 - 如果 bisect 过程中改过代码又没
git stash，reset 会丢掉那些改动——提前git stash push -m "bisect-temp"更安全
