Plan Mode
基于 Cursor 官方 Plan Mode 文档解释先研究、提问、生成计划、审查编辑，再批准构建的流程。
Plan Mode 是 Cursor 处理复杂任务前的刹车。官方文档说明，它会在写代码之前创建详细 implementation plan：Agent 先研究代码库、提出澄清问题、生成可审查计划，你可以编辑计划后再让它构建。
阅读目标：读完本章，你应该能判断什么任务必须先 Plan，并能审查计划的范围、文件、风险、验证和保存位置。
1. 怎么进入 Plan Mode
官方文档列出两种切换方式：
| 方式 | 说明 |
|---|---|
Shift+Tab | 在 chat input 中循环切换到 Plan Mode |
| Mode picker dropdown | 在 Agent 中用模式选择器切换 |
Cursor 也会在你输入复杂任务相关关键词时自动建议 Plan Mode。
2. Plan Mode 的官方流程
官方流程可以拆成五步：
flowchart TD
Task["复杂任务"] --> Questions["Agent asks clarifying questions"]
Questions --> Research["Researches codebase"]
Research --> Plan["Creates implementation plan"]
Plan --> Review["User reviews / edits plan"]
Review --> Build["Click to build when ready"]这和普通 Agent 最大区别是：它不是立刻写代码，而是先把“准备怎么做”暴露出来。
3. 什么时候用 Plan Mode
官方文档说 Plan Mode 最适合：
| 场景 | 原因 |
|---|---|
| 有多种实现路径的复杂功能 | 需要先比较方案 |
| 触碰很多文件或系统的任务 | diff 风险大，需要先定范围 |
| 需求不清晰 | 需要先提问和探索 |
| 架构决策 | 需要先审查 approach |
不一定需要 Plan Mode：
- 很小的文案修复。
- 你已经做过很多次的重复小任务。
- 单文件、低风险、容易回退的改动。
4. Plan 保存位置
官方文档说明，plans 默认保存到 home directory。你可以点击 Save to workspace，把计划移到 workspace，用于未来参考、团队共享和文档化。
判断方式：
| 情况 | 建议 |
|---|---|
| 个人临时探索 | 默认 home 即可 |
| 团队需要复用方案 | Save to workspace |
| 计划涉及产品、架构、迁移 | Save to workspace 并纳入文档 |
| 计划包含敏感信息 | 不保存进仓库，先脱敏 |
Save to workspace 之前先确认计划里没有密钥、私人路径、客户数据或未脱敏日志。
5. 计划没对齐时，回到 plan
官方文档特别提醒：如果 Agent 构建出来的东西不符合预期，不要只靠 follow-up prompts 修补。更稳的是：
- Revert changes。
- 回到 plan。
- 把计划写得更具体。
- 再运行一次。
深读：为什么重写 plan 往往比修补 in-progress agent 更快
复杂任务失败时，问题通常不是“少补一句提示词”，而是初始方案就不够精确。继续在已经偏离的实现上修补，会让 diff 越来越乱。
回到 plan 等于回到任务边界：重新定义目标、文件范围、技术路线、验证命令和停止点。对较大的任务，这通常比追着已有错误改更干净。
6. Plan 审查清单
点 Build 前至少检查：
- 是否列出相关文件和模块。
- 是否回答了澄清问题。
- 是否给出明确实现路径。
- 是否说明测试、lint、build 或浏览器验证。
- 是否有回退策略。
- 是否扩大到未授权范围。
- 是否包含敏感信息。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Plan Mode 和普通 Agent mode 的核心差异是什么？
- 哪些任务必须先用 Plan Mode？
- 为什么构建结果不对时，应该考虑回到 plan 而不是继续追问修补？
通过标准：你能审查一份 Cursor implementation plan，并决定是否 build、修改、保存到 workspace 或放弃。
官方来源
- Cursor Plan Mode —— 官方说明 Plan Mode 流程、切换方式、适用场景、保存位置和重新从 plan 开始。
- Cursor Agent Help —— Help Center 说明 Ask / Agent / Plan / Debug 模式选择。