用途:提供系统化的问题排查与错误分析方法,帮助开发者有条理地定位缺陷,而非随机试错。
主要能力:
- 调试思维流程:复现、隔离、假设、测试、修复(只改一处)、验证。
- 二分查找调试:在已知正常状态与已知异常状态之间测试中点,逐步缩小范围;可用 git bisect 自动化,命令包括 git bisect start、git bisect bad、git bisect good <known-good-sha>、git bisect reset。
- 堆栈跟踪阅读:自下而上获取上下文,自上而下定位原因,优先查看最靠近错误抛出的帧。
- 常见错误分类:如 undefined is not a function、Cannot find module、ENOENT、EACCES、静默失败、本地正常但 CI 失败等,并给出可能原因与检查方向。
- 日志策略:避免无信息日志,使用带函数名、输入与状态的上下文日志或结构化日志。
- 橡皮鸭调试:通过口头或文字逐步解释问题、预期与实际行为,常能暴露缺陷。
- 假设检验:基于证据提出假设并加日志确认,而非随意改动。
- 环境调试:检查环境变量、版本与已安装依赖,如 $env:PATH、$env:NODE_ENV、node --version、npm --version、code --version、npm list --depth=0。
- 反模式提醒:一次改多处、无证据臆断、忽略错误信息、只强调“在我机器上正常”、删除错误处理来“修复”错误。
使用方式:按上述流程逐步执行,结合 git bisect 与日志验证假设。资料未提供具体安装命令或集成方式。
适用场景:本地开发排错、回归定位、CI 与本地环境差异排查、错误信息分析。
限制:资料未说明支持的平台、语言、收费或价格,也未提供完整代码示例与安装步骤。