用 Cursor Agent 模式排查疑难 bug 的方法
本文给出用 Cursor Agent 模式定位和修复隐藏较深的 bug 的排查思路和使用技巧。
排查思路
用 Cursor Agent 模式排查疑难 bug，通常不是靠"直接问 AI 怎么修"就能解决的，更有效的方式是先让它帮你收集信息：复现步骤是什么、涉及哪些文件、日志里有没有异常信息。把这些线索明确交给 Agent，而不是笼统地说"这里有个 bug 帮我修一下"，能大幅提升定位效率。
Agent 模式的关键作用
据 Cursor 官方说明[1]，Agent 模式相比普通对话的优势在于能自主跨文件搜索、读取相关代码、甚至运行命令验证假设，这对排查那种"表面现象在这个文件，根因在另一个文件"的问题特别有用，人工手动逐个文件排查往往很耗时，Agent 模式可以并行处理这类信息收集工作。
使用建议
建议先让 Agent 只做定位和分析，给出可能的根因和修复方案，而不是让它直接改代码，确认分析思路合理之后再让它执行具体的修复。这样即使 Agent 的初步判断有偏差，也能在动手改代码之前及时纠正，避免在错误的方向上浪费改动。
复盘经验
修复完成后，建议花几分钟回顾一下这个 bug 是怎么产生的、有没有类似的隐患存在于其他地方，Agent 模式也可以用来做这类关联排查，主动搜索项目里是否存在相似的代码模式可能引发同类问题。
常见问题
Agent 模式排查 bug 会不会比自己手动排查更慢？
对于简单明显的问题，自己手动排查可能更快；对于涉及多个文件、调用链较深的复杂问题，Agent 模式的并行搜索能力通常能节省不少时间。
应该完全信任 Agent 给出的根因分析吗？
不建议完全依赖，AI 的分析也可能出现偏差，尤其是涉及业务逻辑判断的部分，建议结合自己对项目的理解做交叉验证。
修复方案应用后要不要再手动测试？
需要，自动化的修复不能替代人工验证，尤其是这类隐藏较深的问题，修复后最好针对原始复现步骤重新验证一遍。