用途:提供系统化的问题排查与错误分析方法,帮助开发者定位并修复缺陷。
主要能力:
- 调试思维流程:复现、隔离、假设、测试、修复(只改一处)、验证。
- 二分查找调试:通过已知正常状态与已知异常状态定位引入问题的变更,可用 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 失败等,并给出可能原因与检查方向。
- 日志策略:避免无信息日志,推荐结构化日志,例如 log.debug({ fn: 'processData', input: data, state }, 'Processing started')。
- 橡皮鸭调试:通过口述或文字解释问题、预期与实际行为、逐步走查代码来发现缺陷。
- 假设测试:基于证据提出假设并验证,而非随机改动。
- 环境调试:检查环境变量($env:PATH、$env:NODE_ENV)、版本(node --version、npm --version、code --version)及已安装包(npm list --depth=0)。
- 反模式提醒:避免同时改多处、无证据臆断、忽略错误信息、只称“在我机器上正常”而不排查、删除错误处理来“修复”错误。
使用方式:按上述流程与技巧逐步排查;二分查找可借助 git bisect 命令;日志与环境检查命令保持原样使用。
适用场景:本地或 CI 环境中的代码缺陷定位、回归问题排查、错误信息分析。
限制:资料未提供具体平台、收费、价格或效果说明;synapses.json 的连接内容暂未提供。