跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

Debug Mode 证据驱动排障

通过假设、日志插桩、复现与验证定位问题,并在修复后清理诊断代码。

Debug Mode 适合可复现但原因不明的 bug、竞态、性能问题和回归。它先收集运行信息,再做针对性修复。

工作流程

  1. 探索相关文件并提出多个原因假设。
  2. 添加日志插桩,把运行数据送到 Cursor 扩展中的本地 debug server。
  3. 按 Agent 提供的步骤复现问题。
  4. 根据实际日志排除或确认假设。
  5. 针对根因修改代码。
  6. 再次复现验证,确认后移除插桩。

从 Agent 模式选择器切换,Shift+Tab 也可快速轮换模式。

提供必要信息

同时描述预期与实际行为,提供报错、堆栈和精确复现步骤。竞态可能需要多次复现才能捕获异常路径,不应把一次未复现当作修复完成。

检查收尾

确认原始问题已解决、相关测试通过,以及临时日志已清理。日志中没有异常不能单独证明代码正确,还需检查是否实际执行了触发路径。

若需求或预期行为本身还不明确,先用Plan Mode澄清;只查代码结构时用Ask。