Git使用二分法git bisect精准定位Bug的全面指南

# 示例：web 应用
# 好：页面能正常加载，功能正常
# 坏：页面崩溃，功能异常
# 示例：命令行工具  
# 好：命令执行成功，返回正确结果
# 坏：命令崩溃，返回错误结果
# 示例：单元测试
# 好：所有测试通过
# 坏：特定测试失败

# 确保在正确的分支上
git checkout main  # 或者你发现问题的分支

# 启动 bisect 会话
git bisect start

# 标记当前提交为"坏"（包含 bug）
git bisect bad

# 标记一个已知的"好"提交（不包含 bug）
# 方法1：使用具体的 commit hash
git bisect good a1b2c3d4

# 方法2：使用分支名或标签
git bisect good v1.0.0
git bisect good main~50  # 50个提交之前

# 方法3：如果你知道大概时间
git bisect good $(git rev-list -n 1 --before="2026-03-01" main)

# 设置后的典型输出
bisecting: 337 revisions left to test after this (roughly 9 steps)
[8f7e6d5c] some commit message

# 如果当前提交有 bug（坏的）
git bisect bad

# 如果当前提交没有 bug（好的）  
git bisect good

# 如果当前提交无法测试（比如编译失败）
git bisect skip

# 成功找到问题提交！
8f7e6d5c9a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5 is the first bad commit
commit 8f7e6d5c9a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5
author: john doe <john@example.com>
date:   mon apr 15 10:30:00 2026 +0800

    fix user authentication issue
    
    - updated auth logic
    - added new validation rules

:100644 100644 abc123... def456... m    src/auth.js

# 返回到原始状态
git bisect reset

# 或者返回到特定提交
git bisect reset main

# 创建测试脚本 test-bug.sh
#!/bin/bash
# 这个脚本应该：
# - 返回 0 表示"好"（无 bug）
# - 返回非 0 表示"坏"（有 bug）

# 示例：运行特定测试
npm test -- --testnamepattern="auth failure test"

# 或者：检查特定文件是否存在
if [ -f "broken-feature.log" ]; then
    exit 1  # 有 bug
else
    exit 0  # 无 bug
fi

# 启动自动化 bisect
git bisect start
git bisect bad head
git bisect good v1.0.0
git bisect run ./test-bug.sh

#!/bin/bash
# test-web-app.sh

# 启动应用（后台）
npm start &
app_pid=$!

# 等待应用启动
sleep 5

# 测试关键功能
if curl -s http://localhost:3000/api/health | grep -q "ok"; then
    # 功能正常
    kill $app_pid
    exit 0
else
    # 功能异常
    kill $app_pid  
    exit 1
fi

#!/bin/bash
# test-python-app.sh

# 运行特定测试用例
python -m pytest tests/test_auth.py::test_login_failure

# pytest 返回 0 表示通过（好），非 0 表示失败（坏）
# 所以直接返回 pytest 的退出码即可
exit $?

# 你可以指定多个好提交
git bisect good commit1 commit2 commit3

# 或者多个坏提交  
git bisect bad commita commitb

# 当遇到编译失败或依赖问题的提交时
git bisect skip

# git 会自动选择其他提交继续

# 对于不是 bug 而是性能回归的情况
git bisect start --term-old=fast --term-new=slow
git bisect slow head          # 当前版本慢
git bisect fast v1.0.0        # v1.0.0 版本快

# 查看当前 bisect 状态
git bisect visualize  # 显示当前搜索范围

# 查看 bisect 日志
git bisect log

# 重置到特定状态
git bisect reset head  # 重置到当前 head
git bisect reset       # 重置到 bisect 开始前的状态

# 1. 启动 bisect
git bisect start

# 2. 标记范围
git bisect bad head        # 当前版本有问题
git bisect good v2.1.0     # v2.1.0 版本正常

# git 输出：
# bisecting: 25 revisions left to test after this (roughly 5 steps)
# [a1b2c3d4] refactor authentication service

# 3. 测试当前提交 (a1b2c3d4)
# 手动测试登录功能...
# 发现仍然无法登录

git bisect bad             # 标记为坏

# git 自动切换到下一个中间提交
# bisecting: 12 revisions left to test after this (roughly 4 steps)  
# [e5f6g7h8] update user validation rules

# 4. 测试当前提交 (e5f6g7h8)
# 测试登录功能...
# 发现可以正常登录！

git bisect good            # 标记为好

# 继续这个过程...

# 5. 最终结果
d9e8f7c6b5a4c3b2a1d0e9f8c7b6a5d4c3b2a1d0 is the first bad commit
commit d9e8f7c6b5a4c3b2a1d0e9f8c7b6a5d4c3b2a1d0
author: alice developer <alice@company.com>
date:   wed apr 18 14:22:00 2026 +0800

    fix password validation
    
    - changed regex pattern for password strength
    - added special character requirement

:100644 100644 old_hash new_hash m    src/validation.js

# 退出 bisect 会话
git bisect reset

# 修复问题
# 提交修复

# 基础命令
git bisect start                    # 启动 bisect
git bisect bad [commit]             # 标记坏提交
git bisect good [commit]            # 标记好提交  
git bisect reset [commit]           # 退出 bisect 会话

# 自动化
git bisect run <script>             # 运行自动化测试脚本

# 调试
git bisect log                      # 查看 bisect 日志
git bisect visualize                # 可视化当前范围
git bisect skip [commit]            # 跳过无法测试的提交

# 高级选项
git bisect start --first-parent     # 忽略合并提交的复杂性
git bisect start --term-old=x --term-new=y  # 自定义术语