Cursor Plan模式保姆级使用教程｜复杂项目开发不再翻车

文章适配CSDN排版，自带标题层级、代码块、目录友好，可直接复制发布

目录

1. 前言：为什么要用Plan模式

2. Plan模式是什么，和Agent/Ask区别

3. 三种方式激活Cursor Plan模式

4. 标准完整开发工作流实战

5. Plan模式高质量Prompt写法

6. 适用场景 & 避坑指南

7. 进阶优化：搭配.cursorrules统一计划输出格式

1 前言：为什么要用Plan模式

很多人使用Cursor直接用默认Agent模式开发，遇到跨多文件重构、大型功能开发时经常出现问题：
AI理解出现偏差，一通修改多个文件，写完发现方案不符合预期，大量代码需要回滚，浪费大量时间。

Cursor推出的 Plan（计划模式） 完美解决该痛点：先制定开发方案，人工审核确认方案无误后，再执行代码修改。
先规划、再评审、最后编码，把AI自由发挥的风险前置，适合工程化开发。

2 Plan模式是什么，和Agent/Ask区别

Cursor侧边栏对话内置三种核心模式，三者分工完全不同：
模式 核心逻辑 适用场景
Plan 计划模式 先输出完整实施方案，人工确认Build后才修改代码 多文件开发、项目重构、架构调整、复杂需求
Agent 默认模式 收到指令直接读取代码、修改文件 小型功能、局部bug修复、少量代码调整
Ask 查询模式 只读模式，不会改动项目任何代码 代码阅读、逻辑查询、技术答疑

简单总结：小需求用Agent；查代码用Ask；大型复杂需求优先开启Plan。

3 三种方式激活Cursor Plan模式

方式1：快捷键（推荐日常使用）

1. 唤起对话窗口：Cmd+I（Mac） / Ctrl+I（Windows/Linux）

2. 在输入框按下 Shift + Tab 快速切换模式

3. 窗口顶部标题出现 Plan 代表切换成功

方式2：下拉菜单可视化切换

打开AI聊天面板，点击顶部模式下拉框（默认显示Agent），直接选择 Plan。

方式3：斜杠指令一键切换

在对话输入框输入指令回车，快速切换：
/plan
补充：当检测到你输入大型复杂需求时，Cursor有时会自动弹窗建议切换Plan模式。

4 标准完整开发工作流实战

步骤1：输入清晰需求，善用@关联代码文件

使用 @ 选中项目内相关源码，强制AI读取上下文，避免AI不了解项目结构瞎写。
示例：
@src/components/dialog.vue 基于现有弹窗组件开发分享弹窗
需求清单：

1. 支持微信、朋友圈、链接复制分享
2. 适配深色/浅色模式
3. 不新建基础弹窗组件，复用现有样式
4. 添加分享行为埋点
   输出完整开发计划
   步骤2：及时回应AI的澄清提问

开启Plan模式后，AI会先扫描项目代码，针对模糊需求主动提问确认边界。
务必完整回复，需求边界没对齐，生成的开发计划一定会存在缺陷。

步骤3：审阅、编辑生成的Plan方案

AI会生成一份虚拟 plan.md 方案文档，一般包含内容：

• 需求拆解梳理

• 技术方案选型说明

• 分步骤任务清单

• 需要改动的全部文件列表

• 自测验证方案

你可以直接在编辑器内编辑这份计划：

• 删除不需要的开发步骤

• 调整任务执行先后顺序

• 补充遗漏功能、增加技术约束

• 修改不合理的实现方案

步骤4：确认方案，点击Build执行开发

方案审核完成，点击文档右下角 Build 按钮。
Cursor会自动切换执行模式，严格按照定稿计划，分步完成新建文件、修改代码。

步骤5（可选）保存计划文档

可将虚拟plan.md另存到项目目录，作为开发文档留存，方便后续复盘、团队交接。

5 Plan模式高质量Prompt写法模板

通用模板直接复制使用：
启用Plan模式，根据下面需求输出完整开发方案：
【功能目标】
xxx

【技术约束】

1. 复用现有项目组件，禁止新增基础通用组件
2. 遵循项目现有代码规范
3. 兼容现有接口结构，不要改动底层基础逻辑

【禁止实现】
xxx

方案结构要求：

1. 需求分析
2. 整体技术方案
3. 文件变更清单
4. 分步开发任务清单
5. 自测要点
   6 适用场景 & 避坑指南

✅ 强烈推荐使用Plan模式

• 跨多个文件、多个模块的新功能开发

• 项目代码重构、模块拆分、技术升级

• 需求比较模糊，需要先梳理实现路线

• 担心AI乱改代码，需要提前审核方案

• 开发任务较大，需要任务清单方便跟踪

❌ 不建议开启Plan模式

• 单行代码修改、简单bug修复

• 局部函数优化、简单格式调整
这类场景直接使用默认Agent模式，效率更高。

常见坑

1. 不使用@关联文件，AI无法读取项目上下文，方案脱离现有代码

2. 跳过审核直接Build，等同于失去Plan模式的核心价值

3. 过于细碎的小任务强行使用Plan，增加不必要操作成本

7 进阶优化：搭配.cursorrules统一计划输出格式

在项目根目录新建 .cursorrules，写入规则，每次开启Plan模式AI自动按照固定格式输出方案：
当切换至Plan模式进行开发时，输出的plan.md必须遵循以下结构：

开发方案

1. 需求概述

2. 技术方案说明

3. 需要修改/新建文件清单

4. 分步开发任务（有序列表）

5. 测试验证标准

禁止输出多余闲聊内容，方案清晰、落地性优先。
结尾总结

Plan模式本质是给AI开发增加一道人工审核关卡。个人开发、团队协作都能显著降低代码返工率。
养成习惯：小功能Agent直接写；大型需求先Plan规划，审核方案再编码，最大化发挥Cursor的开发效率。