Vibe session · Learning mode阅读、尝试、提问都留在同一个工作区
Course Map
练习进度 0/55
Learning Guide
Build session

Cursor 进阶 — 多文件编辑和 Agent 模式

intermediate · 12-15 min · 步骤 1/4

你有没有试过让 AI 同时改 5 个文件,然后全部改对了?

说实话,我第一次体验到这个的时候,整个人是懵的。

当时我在做一个电商项目,产品经理突然说要给所有商品卡片加一个"收藏"按钮。这个需求听起来简单,但实际涉及到的文件是这样的:新建一个 FavoriteButton.tsx 组件、修改 ProductCard.tsx 引入这个按钮、修改 types.ts 加一个 isFavorited 字段、修改 api/products.ts 加收藏和取消收藏的接口调用、修改 useProducts.ts Hook 里的状态管理。五个文件。

以前用 ChatGPT 写这种东西,我得分五次对话,每次把相关文件的代码贴进去,让 AI 生成一段,再复制回来。整个过程 20 分钟打底,而且中间特别容易出错——比如 API 返回的字段名在 types.ts 和 useProducts.ts 里写的不一样。

用 Cursor 的 Composer 呢?我说了一句:"给商品卡片添加收藏功能,需要新建 FavoriteButton 组件、修改 ProductCard 引入、在 API service 里加收藏接口、在 useProducts Hook 里管理收藏状态。用心形图标,已收藏显示红色填充,未收藏显示灰色描边。"

然后我看着 Cursor 同时在 5 个文件标签页上开始"写代码"。大概 30 秒后,每个文件的改动都以 diff 的形式展示出来——绿色是新增的行,红色是删掉的行。我逐个看了一遍,类型定义是一致的,API 调用方式跟项目里已有的风格一样,组件的 props 类型也是对的。全部 Accept,跑起来,直接就能用。

3 分钟。从"产品经理提需求"到"功能可以测试",3 分钟。

Cursor Composer 多文件编辑界面——左侧代码 diff 预览,右侧对话交互

多文件编辑的策略

不过话说回来,并不是所有多文件编辑都这么顺利。我踩过很多坑之后,总结了几个让 Cursor 多文件编辑更靠谱的策略:

策略一:在指令里明确列出涉及的文件。

你可能觉得"AI 应该自己知道要改哪些文件啊"。有时候它确实能猜对,但更多时候它会遗漏。比如你说"加一个暗色主题",Cursor 可能只改了组件的样式,忘了改 tailwind.config.ts 里的颜色定义。所以最好在指令里直接列出来:

做法效果
"加一个暗色主题"AI 可能遗漏某些文件
"加一个暗色主题,需要修改:tailwind.config.ts(定义暗色颜色变量)、ThemeProvider.tsx(添加主题切换逻辑)、Header.tsx(加切换按钮)"AI 知道确切要改哪些文件,不会遗漏
策略二:用 @ 引用锚定相关文件。

如果你没法列出所有文件名,至少用 @ 引用你知道的关键文件。比如:参考 @src/styles/theme.ts 里已有的主题定义方式,帮我加一套暗色主题。这样 Cursor 会读取那个文件,理解你的主题定义模式,然后在其他文件里保持一致。

策略三:大改动分步走。

我踩过最大的坑就是一次让 Cursor 改太多。超过 7-8 个文件的时候,AI 的输出质量就开始明显下降——可能前几个文件改得很好,后面几个就开始"糊弄"了。所以如果你的需求涉及很多文件,最好拆成几步:

第一步:先创建类型定义和 API 接口
第二步:创建核心组件
第三步:在已有页面里引入新组件

每一步做完 Accept + 测试 + git commit,再做下一步。这样即使某一步出了问题,你也能精确回退。

Cline 插件多文件编辑实战——同时处理多个文件的 API Request 和代码修改

策略四:先让 AI 规划,再让它执行。

对于真正复杂的跨文件修改,我的习惯是先说:"我想做 XXX,帮我列一个实施计划,包括需要修改哪些文件、每个文件改什么。" 等我看完计划觉得合理了,再说"按这个计划执行"。

开发工具与 AI 调教指南——Workflow 工具流 + Prompt 提示词的高效组合

这个"先规划后执行"的模式能省你很多后悔的时间。

Vibe Workspace
Live build context

多文件编辑——Cursor 真正的杀手锏

理解 Cursor 多文件编辑的工作方式,以及为什么它是 Vibe Coding 的核心能力

自动保存在此设备
掌握 Cursor 多文件编辑的操作策略和最佳实践理解 Agent 模式的工作原理及其与普通 Composer 的区别学会利用图片输入实现截图转代码的工作流
Home| Vibe Lab
草稿自动保存