二分查找与调试

# 第 1 步：启动 bisect
git bisect start

# 第 2 步：标记当前版本为"坏"（有 bug）
git bisect bad                    # 当前 HEAD 有 bug

# 第 3 步：标记已知正常的版本为"好"
git bisect good v1.0.0            # v1.0.0 标签对应的版本正常
# 或使用 commit hash
git bisect good abc1234

# 此时 Git 自动 checkout 到中间 commit，并提示：
# "Bisecting: 3 revisions left to test after this (roughly 2 steps)"

# 测试当前 checkout 的版本...

# 如果正常：
git bisect good

# 如果有 bug：
git bisect bad

# Git 再次 checkout 到新的中间点，重复上述步骤

abc1234 is the first bad commit
commit abc1234def5678901234567890abcdef12345678
Author: 张三 <zhangsan@example.com>
Date:   Fri Jan 15 14:30:00 2025 +0800

    refactor: 重构认证模块

:040000 040000 abc123 def456 M  src

git bisect reset

git bisect start
git bisect bad HEAD
git bisect good v1.0.0
git bisect run <test-script>

# 假设 npm test 在有 bug 的版本上会失败（退出码非 0）
git bisect start
git bisect bad HEAD
git bisect good v2.0.0
git bisect run npm test
# Git 自动运行 npm test，根据退出码判断好坏
# 最终输出首个坏提交
git bisect reset

#!/bin/bash
# test-login.sh — 测试登录功能是否正常

# 启动测试服务器（后台运行）
npm start &
SERVER_PID=$!

# 等待服务器启动
sleep 5

# 发送测试请求
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
  -X POST http://localhost:3000/api/login \
  -d '{"username":"test","password":"test123"}')

# 停止服务器
kill $SERVER_PID 2>/dev/null

# 判断结果
if [ "$HTTP_CODE" = "200" ]; then
    exit 0    # 正常 → good
elif [ "$HTTP_CODE" = "500" ]; then
    exit 1    # 有 bug → bad
else
    exit 125  # 无法测试（服务器未启动等）→ skip
fi

chmod +x test-login.sh
git bisect start
git bisect bad HEAD
git bisect good v1.0.0
git bisect run ./test-login.sh

# 查找某个错误配置项何时被引入
git bisect start
git bisect bad HEAD
git bisect good v1.0.0
git bisect run sh -c 'grep -q "deprecated_option" config.yml && exit 1 || exit 0'
# 如果 config.yml 中包含 deprecated_option → bad (exit 1)
# 如果不包含 → good (exit 0)

# 手动模式：跳过当前 commit
git bisect skip

# 自动化模式：测试脚本返回退出码 125
# Git 自动执行 skip

# 跳过指定的 commit
git bisect skip abc1234 def5678

# 跳过某个范围内的 commit（通过 rev-list）
git bisect skip $(git rev-list v1.0.0..v1.1.0 --grep="WIP")

git bisect log

git bisect start
# bad: [abc1234] feat: 添加新支付模块
git bisect bad abc1234
# good: [v1.0.0] release: v1.0.0
git bisect good v1.0.0
# good: [def5678] fix: 修复缓存问题
git bisect good def5678
# bad: [ghi9012] refactor: 重构认证模块
git bisect bad ghi9012
# good: [jkl3456] chore: 升级依赖
git bisect good jkl3456
# first bad commit: [mno7890] refactor: 修改密码验证逻辑

git bisect log > bisect-log.txt

# 先重置当前 bisect 状态
git bisect reset

# 从日志文件重放
git bisect replay bisect-log.txt

# 1. 开始 bisect 并记录日志
git bisect start
git bisect bad HEAD
git bisect good v1.0.0
git bisect log > bisect-log.txt

# 2. 继续操作...但发现某一步标记错了
git bisect good   # 误标记！应该是 bad

# 3. 修正：重置并编辑日志
git bisect reset
# 编辑 bisect-log.txt，将误标记的 good 改为 bad
git bisect replay bisect-log.txt

# 4. 从修正后的状态继续 bisect

# 查看文件每一行的归属
git blame src/auth/login.ts

^a1b2c3d (张三 2025-01-10 10:30:15 +0800  1) import { Injectable } from '@angular/core';
e4f5g6h7 (李四 2025-02-20 14:22:33 +0800  2) import { HttpClient } from '@angular/common/http';
e4f5g6h7 (李四 2025-02-20 14:22:33 +0800  3)
^a1b2c3d (张三 2025-01-10 10:30:15 +0800  4) @Injectable({ providedIn: 'root' })
a1b2c3d (张三 2025-03-05 09:15:42 +0800  5) export class LoginService {
c9d0e1f2 (王五 2025-04-12 16:45:00 +0800  6)   private maxRetries = 3;
c9d0e1f2 (王五 2025-04-12 16:45:00 +0800  7)   private timeout = 5000;

# 忽略所有空白差异（空格、Tab、空行增删）
git blame -w src/auth/login.ts

# 不加 -w：缩进调整被归因于格式化提交
f1e2d3c4 (张三 2025-06-01 10:00:00  5)   export class LoginService {    # 仅改了缩进
f1e2d3c4 (张三 2025-06-01 10:00:00  6)     private maxRetries = 3;       # 仅改了缩进

# 加 -w：忽略缩进变更，追溯到原始逻辑修改
a1b2c3d (王五 2025-04-12 16:45:00  5)   export class LoginService {    # 真正的修改
c9d0e1f (王五 2025-04-12 16:45:00  6)     private maxRetries = 3;       # 真正的修改

# 检测从其他文件复制或移动来的代码行
git blame -C src/auth/login.service.ts

# 更激进的检测（检测更多来源文件）
git blame -CC src/auth/login.service.ts

# 最激进的检测（扫描所有文件）
git blame -CCC src/auth/login.service.ts

# 检测同一文件内的行移动
git blame -M src/auth/login.ts

# 指定相似度阈值（默认 60%）
git blame -M80% src/auth/login.ts   # 相似度 >= 80% 才视为移动

# 同时检测行内移动和跨文件复制
git blame -M -C src/auth/login.ts

# 查看第 10 到 30 行的归属
git blame -L 10,30 src/auth/login.ts

# 从第 10 行起 5 行
git blame -L 10,+5 src/auth/login.ts

# 使用正则匹配行范围
git blame -L "/class LoginService/",+20 src/auth/login.ts
# 从匹配 "class LoginService" 的行开始，显示 20 行

# 匹配函数范围
git blame -L "/function handleAuth/",/^}/ src/auth/login.ts
# 从 handleAuth 函数开始到下一个闭合大括号

# 启动 GUI blame
git gui blame src/auth/login.ts

# git-quick-blame：快速 blame 当前文件的指定行
# 安装：npm install -g git-quick-blame

# delta：增强 diff 和 blame 的显示
# 安装：brew install git-delta
git config --global interactive.diffFilter "delta --color-only"

#!/bin/bash
# scripts/test-login-bug.sh
# 测试登录功能是否存在 500 错误

set -e

# 构建项目（如果构建失败，标记为 skip）
if ! npm install --quiet 2>/dev/null; then
    exit 125  # 无法测试
fi

if ! npm run build 2>/dev/null; then
    exit 125  # 构建失败，跳过
fi

# 启动服务器
npm start &
SERVER_PID=$!
sleep 8

# 检查服务器是否启动
if ! curl -s http://localhost:3000/health > /dev/null 2>&1; then
    kill $SERVER_PID 2>/dev/null || true
    exit 125  # 服务器未启动，跳过
fi

# 执行登录测试
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
    -X POST http://localhost:3000/api/login \
    -H "Content-Type: application/json" \
    -d '{"username":"testuser","password":"testpass123"}')

# 清理
kill $SERVER_PID 2>/dev/null || true
wait $SERVER_PID 2>/dev/null || true

# 判断结果
if [ "$HTTP_CODE" = "200" ]; then
    exit 0    # 正常
elif [ "$HTTP_CODE" = "500" ]; then
    exit 1    # 有 bug
else
    exit 125  # 无法确定，跳过
fi

# 赋予脚本执行权限
chmod +x scripts/test-login-bug.sh

# 启动 bisect
git bisect start
git bisect bad v2.0.0
git bisect good v1.0.0

# 记录 bisect 日志
git bisect log > /tmp/bisect-log.txt &

# 自动运行
git bisect run ./scripts/test-login-bug.sh

c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8 is the first bad commit
commit c9d0e1f2
Author: 张三 <zhangsan@example.com>
Date:   Mon Feb 10 09:30:00 2025 +0800

    refactor: 重构密码验证逻辑

:100644 100644 abc123 def456 M  src/auth/password-validator.ts
:100644 100644 789abc 012def M  src/auth/login.service.ts

git show c9d0e1f2

# 追踪问题文件中关键函数的归属
git blame -C -M -L "/validatePassword/",+30 src/auth/password-validator.ts

# 追踪特定行范围
git blame -C -L 45,65 src/auth/login.service.ts

# 查看该行代码在原始提交中的上下文
git show <original-commit> -- src/auth/password-validator.ts

# 查看该文件的完整变更历史
git log --follow -p -- src/auth/password-validator.ts

# 搜索特定函数名的变更历史
git log -S "validatePassword" --oneline -- src/auth/

# 编写回归测试（确保此 bug 不会再次出现）
# ... 编辑测试文件 ...

# 提交修复
git add .
git commit -m "fix: 修复密码验证逻辑导致的 500 错误

问题由 c9d0e1f2 引入，该提交重构了密码验证逻辑，
遗漏了对空密码的边界检查。

添加回归测试以防止同类问题再次发生。"

# 重置 bisect 状态
git bisect reset