Debug Mode 证据驱动排障
通过假设、日志插桩、复现与验证定位问题,并在修复后清理诊断代码。
Debug Mode 适合可复现但原因不明的 bug、竞态、性能问题和回归。它先收集运行信息,再做针对性修复。
工作流程
- 探索相关文件并提出多个原因假设。
- 添加日志插桩,把运行数据送到 Cursor 扩展中的本地 debug server。
- 按 Agent 提供的步骤复现问题。
- 根据实际日志排除或确认假设。
- 针对根因修改代码。
- 再次复现验证,确认后移除插桩。
从 Agent 模式选择器切换,Shift+Tab 也可快速轮换模式。
提供必要信息
同时描述预期与实际行为,提供报错、堆栈和精确复现步骤。竞态可能需要多次复现才能捕获异常路径,不应把一次未复现当作修复完成。
检查收尾
确认原始问题已解决、相关测试通过,以及临时日志已清理。日志中没有异常不能单独证明代码正确,还需检查是否实际执行了触发路径。