---
title: "Plan Mode"
description: "基于 Cursor 官方 Plan Mode 文档解释先研究、提问、生成计划、审查编辑，再批准构建的流程。"
verifiedAt: "2026-05-09"
---

Plan Mode 是 Cursor 处理复杂任务前的刹车。官方文档说明，它会在写代码之前创建详细 implementation plan：Agent 先研究代码库、提出澄清问题、生成可审查计划，你可以编辑计划后再让它构建。

> [!NOTE]
> **阅读目标**：读完本章，你应该能判断什么任务必须先 Plan，并能审查计划的范围、文件、风险、验证和保存位置。

## 1. 怎么进入 Plan Mode

官方文档列出两种切换方式：

| 方式 | 说明 |
| --- | --- |
| `Shift+Tab` | 在 chat input 中循环切换到 Plan Mode |
| Mode picker dropdown | 在 Agent 中用模式选择器切换 |

Cursor 也会在你输入复杂任务相关关键词时自动建议 Plan Mode。

## 2. Plan Mode 的官方流程

官方流程可以拆成五步：

```mermaid
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 并纳入文档 |
| 计划包含敏感信息 | 不保存进仓库，先脱敏 |

> [!IMPORTANT]
> Save to workspace 之前先确认计划里没有密钥、私人路径、客户数据或未脱敏日志。

## 5. 计划没对齐时，回到 plan

官方文档特别提醒：如果 Agent 构建出来的东西不符合预期，不要只靠 follow-up prompts 修补。更稳的是：

1. Revert changes。
2. 回到 plan。
3. 把计划写得更具体。
4. 再运行一次。

<details>
<summary>深读：为什么重写 plan 往往比修补 in-progress agent 更快</summary>

复杂任务失败时，问题通常不是“少补一句提示词”，而是初始方案就不够精确。继续在已经偏离的实现上修补，会让 diff 越来越乱。

回到 plan 等于回到任务边界：重新定义目标、文件范围、技术路线、验证命令和停止点。对较大的任务，这通常比追着已有错误改更干净。
</details>

## 6. Plan 审查清单

点 Build 前至少检查：

- 是否列出相关文件和模块。
- 是否回答了澄清问题。
- 是否给出明确实现路径。
- 是否说明测试、lint、build 或浏览器验证。
- 是否有回退策略。
- 是否扩大到未授权范围。
- 是否包含敏感信息。

## 本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. Plan Mode 和普通 Agent mode 的核心差异是什么？
2. 哪些任务必须先用 Plan Mode？
3. 为什么构建结果不对时，应该考虑回到 plan 而不是继续追问修补？

通过标准：你能审查一份 Cursor implementation plan，并决定是否 build、修改、保存到 workspace 或放弃。

## 官方来源

- [Cursor Plan Mode](https://cursor.com/docs/agent/plan-mode.md) —— 官方说明 Plan Mode 流程、切换方式、适用场景、保存位置和重新从 plan 开始。
- [Cursor Agent Help](https://cursor.com/help/ai-features/agent.md) —— Help Center 说明 Ask / Agent / Plan / Debug 模式选择。

## 接下来去哪

<Cards>
  <Card title="Agent Review" description="Plan 执行后，继续用 Agent Review 检查本地变更。" href="/docs/cursor/official/01-agent-workflow/15-agent-review" />
  <Card title="Prompting" description="继续学习怎样把任务、上下文、边界和验收写进 prompt。" href="/docs/cursor/official/01-agent-workflow/13-prompting" />
</Cards>
