Appearance
Cursor Plan Mode 让 Agent 在动手写代码前先生成一份详细的实施计划：研究代码库、澄清需求、输出可编辑的方案文档，你确认后才开始执行。按 Shift+Tab 切换，Cursor 也会在你输入复杂任务关键词时自动建议进入 Plan Mode。本文是官方文档的中文改写，介绍何时用 Plan Mode、如何从计划出发重新开始，以及与 Claude Code Plan Mode 的异同。
Cursor Plan Mode：先规划后执行
Plan Mode 是 Cursor Agent 的"思考先行"模式——在写任何代码之前，先研究你的代码库，生成一份你可以审阅和编辑的详细实施计划。
按 Shift+Tab 切换（或在 Agent 的模式选择下拉框里选）。
Plan Mode 的工作流程
- Agent 提问：先问清楚你的需求，避免误解
- 研究代码库：自动搜索相关文件，收集实现所需的上下文
- 生成实施方案：输出一份结构化的方案文档，包含要修改哪些文件、如何修改
- 你审阅和编辑：在聊天里或直接编辑 Markdown 文件，调整方案细节
- 点击执行：确认后 Agent 才开始写代码
方案默认保存在你的 home 目录。点击"Save to workspace"可以保存到项目里，方便团队共享和留档。
什么时候用 Plan Mode
Plan Mode 在以下场景里特别有价值：
- 功能复杂、有多种实现路径：事先对齐方案，避免 Agent 跑偏
- 横跨多个文件或模块：先看清影响范围，再动手
- 需求模糊、需要先探索：让 Agent 帮你把需求变清晰
- 架构决策：在生成代码之前先确认技术方向
对于简单修改或你已经做过很多次的任务，直接用 Agent 模式更快。
从计划重新开始：比修复更高效
Agent 执行后发现方向不对，不要反复用 follow-up 提示去"打补丁"——这往往越改越乱。
更好的做法：
- 回滚 Agent 的改动（用 Checkpoints 或 git）
- 回到计划，把不清晰的地方写得更具体
- 重新执行
重新规划-执行的时间，通常比修复跑偏的代码更短，结果也更干净。
规则：复杂任务花在写好计划上的时间越多，Agent 执行越精准。"难的部分是想清楚要改什么"——想清楚了，具体实现就可以放心交给 Agent。
与 Claude Code Plan Mode 的对比
两者设计思路相同：让 AI 先规划再动手。
| Cursor Plan Mode | Claude Code Plan Mode | |
|---|---|---|
| 触发方式 | Shift+Tab | Shift+Tab 或 --plan |
| 平台 | 在 IDE 内（Cursor） | CLI / VS Code 扩展 |
| 计划格式 | 方案文档（可保存到工作区） | 对话内生成，可写入文件 |
| 适用场景 | IDE 内开发工作流 | 终端/脚本/CI 等更广泛场景 |
常见问题
Q: Plan Mode 生成的计划可以保存吗？
可以。默认在 home 目录，点击"Save to workspace"保存到项目内。适合团队协作——把 AI 生成的设计方案提交到 git，供成员审查。
Q: Plan Mode 和直接让 Agent 做有什么本质区别？
直接 Agent 模式下，AI 会立刻开始读文件、写代码。Plan Mode 先停下来规划，你有机会在 AI 动手前修正方向。对于复杂任务，Plan Mode 能显著减少"方向跑偏后推倒重来"的情况。
Q: Plan Mode 适合日常小改动吗？
不适合，会显得太繁琐。Plan Mode 主要针对跨多文件的大任务或需求不清晰的情况。日常小修小改直接在 Agent 模式里聊就行。