Skip to content
FunCoding

Search

Search docs, Skills and MCP

Debug Mode 证据驱动排障

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

This page has not been translated into English yet. The original Chinese version is shown below.

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

工作流程

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

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

提供必要信息

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

检查收尾

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

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