debugging-and-error-recovery

Overview

五步排错 —— reproduce / localize / reduce / fix / guard。禁止猜根因,改改看。

猜是修的最常见反模式:你改了 3 处,test 通过了,但不知道为什么通过 —— 下次同症状复发,你再猜 3 处。猜的 fix 不是 fix,是赌博。

五步法的核心是reproduce first:没 reproduce 命令的 fix,reviewer 无法验证,你也无法在 3 个月后复现。

When to Use

Use when:

• 测试失败(包括之前通过的测试)
• 构建失败(make / npm run build / cargo build 退出非 0)
• 运行时异常 / panic / 段错误
• 行为异常(测试通过但运行错)
• 用户报"X 不工作了"