如果你曾观察过 Agent 尝试修复 bug,你会发现它其实是在猜。它读代码,想出一个理论,做一个修改,然后祈祷。有时它是对的。但很多时候,你会得到一个看起来很有把握的修复,却悄悄隐藏了真正的 bug。
Debug Mode 就是为此而生的。Agent 不再坐在那里推理代码,而是去获取代码在运行时的实际证据。
工作流程如下
- Agent 提出多个假设,并优先从最可能的那个开始处理
- 然后,添加日志来测试一个假设(不触及实现代码)
- 一个微型调试服务器会在程序运行时收集运行时输出到 。cursor/debug.log 文件
- 你重现 bug,Agent 就能读取日志,理解发生了什么,而不必猜测
- Cursor 在日志中找到根本原因,进行修复,并移除它添加的日志
下面是在一个真实 bug 上的演示,加速到大约一分钟:
团队如何使用它
我们内部用 Debug Mode 解决了一些有趣的问题:
- 一个每 20 次运行中才出现 1 次的竞态条件。它会在我们的最佳模型对比运行中损坏 git 元数据。Debug Mode 在不到一小时内就定位到了问题
- 一次内存泄漏,一次追踪就找到了根源。问题出在错误使用前端框架上。修复只有一行代码
- 一个深埋在 C++ 中的原生崩溃。一个通常人们会绕开的 Electron 崩溃。日志让它变得可查找
- 一个已经被放弃的 SSR 闪烁问题。一个没人愿意触碰的渲染 bug,在 Agent 能够看到页面在运行时的行为后,一次修复完成
试试 Shift+Tab(CLI 中也有,通过 /debug 调用)。
我相信人们正在用我想不到的方式使用它,所以记得告诉我!





