用途:当错误并非出现在入口点,而是深层执行中(例如 git init 在错误目录、文件生成在错误位置、数据库以错误路径打开),堆栈跟踪显示长调用链,或不清楚无效数据从何而来时,使用本技能向后追溯调用链,找到最初的触发点,并在源头修复。
主要能力:
- 观察症状:先明确错误表现。
- 找到直接原因:定位直接导致该错误的代码。
- 逐层向上询问“谁调用了它”,沿调用链回溯。
- 检查传入的值(例如空字符串 projectDir 导致 cwd 解析为 process.cwd(),从而在源码目录执行 git init)。
- 找到最初触发点并在源头修复。
添加堆栈信息:无法手动追溯时,在危险操作前加入 instrumentation,用 new Error().stack 捕获完整调用链,并记录目录、cwd、环境变量、时间戳等上下文。在测试中使用 console.error() 而非 logger(可能被抑制);在操作之前而非失败之后记录。可运行 npm test 2>&1 | grep 'DEBUG git init' 捕获输出,从堆栈中定位测试文件、行号与触发模式。
修复后验证:根据复杂度自动选择测试策略。复杂算法或业务逻辑、易出错的数据转换、可能静默失败的关键路径写确定性单元测试;UI 组件、React hooks、简单 CRUD、直接映射或完全确定正确的内容可跳过测试。没有测试时,用类型检查/静态检查、手动验证 UI 变更或代码评审来确认。只写确定性单元测试,不做集成测试、复杂 mock 或异步复杂度。
限制与原则:绝不只修复错误出现的位置,必须追溯到最初触发点;修复后在每一层添加验证,形成纵深防御,使 bug 不再可能发生。资料中提到的示例包括:将 tempDir 改为在 beforeEach 前访问即抛错的 getter,并在 Project.create()、WorkspaceManager、NODE_ENV 守卫和 git init 前的堆栈日志四处添加防御层。