用途:提供系统化调试流程,核心原则是“未完成根因调查前不做修复”,用于测试失败、Bug 与错误、异常行为、性能问题、构建失败,以及在宣称“已修复”之前。
主要能力:四阶段流程。阶段一调查:阅读完整错误信息与堆栈、复现问题、用 git diff 与 git log 检查近期改动、收集日志与控制台输出等证据。阶段二分析:寻找可正常工作的相似代码,对比差异,定位分歧点。阶段三假设:形成“它因为……而失败”的理论,做最小改动验证并确认。阶段四修复:先写能复现 Bug 的测试,再做单一聚焦修改,最后验证测试通过且无回归。
根因追踪:当错误位于调用栈深处时,从错误位置开始向后追溯坏数据来源,直到找到源头,在源头而非症状处修复。
验证协议:铁律是“没有新鲜验证就不宣称完成”。运行验证命令(如 npm test,或 yarn test、pytest 等),读取输出后再声明结果。错误说法是“现在应该能用了”,正确说法是“测试通过:[粘贴输出]”。
危险信号:出现“先临时快速修一下”“就试试改 X”“大概是 X”“现在应该能用了”“看起来修好了”等想法时,应回到阶段一。
快速参考:发现 Bug 后依次进入四阶段;深层堆栈错误则向后追溯到源头并在源头修复;准备宣称修复前先运行验证命令、读取输出,再声明结果。
限制:资料未提供具体安装方式、平台支持、收费与价格信息,暂未提供。