Cursor AI编辑器实战指南⑤:Composer——一次生成整个功能模块

前四篇讲了安装、Tab 补全、Cmd+K 和 Chat 面板。这一篇，讲 Cursor 最有份量的功能之一——Composer。

Composer 是什么？

简单说：Composer 是一个能同时操作多个文件的 AI 编辑界面。

Cmd+K 适合改一段代码，Chat 面板适合讨论方案，而 Composer 能把一个完整的功能模块一次性生成——新建文件、修改已有文件、删除不需要的文件，全在一个界面里完成。

打开方式：Ctrl+Shift+I（Windows）或 Cmd+Shift+I（Mac）。

三种工作模式

Composer 有三种模式，适合不同场景：

1. Create（创建模式）

输入你想做的功能描述，Cursor 会生成所有需要的文件。

比如：

Create a user authentication module with JWT tokens, including login, register, and logout endpoints

Cursor 会自动生成：

• 路由文件
• 控制器文件
• 中间件文件
• 数据库模型
• 测试文件

所有文件都在 Composer 界面里列出，你可以逐个查看、修改，确认后再一起应用到项目中。

2. Edit（编辑模式）

选择项目中已有的多个文件，让 AI 一起改。

比如你发现 API 层有个参数名改了，需要同步更新 Model、Controller 和测试文件——选中这三个文件，在 Composer 里说”把 userId 改为 accountId”，Cursor 会同时处理三个文件。

3. Agent 模式

这是 Composer 最强的模式。你可以给 AI 一个高层次的指令，AI 会自主决定需要改哪些文件、生成哪些新文件。

比如：

重构整个订单模块，使其支持分期付款，并添加相关的数据库迁移
AI 会：分析现有代码结构 → 决定需要改哪些文件 → 编写新的数据库迁移脚本 → 更新订单模型 → 修改业务逻辑 → 编写测试。
你只需要说「做什么」，不需要说「怎么做」。
实战：用 Composer 重构一个功能
假设你要把项目从 JavaScript 迁移到 TypeScript。用 Composer Agent 模式：
Convert the entire auth module to TypeScript. Add proper type definitions, interfaces for User and Session, and update all function signatures.
Cursor 会分析现有文件结构，生成 TypeScript 类型定义文件，逐个文件转换语法，自动添加类型注解。
过程中你可以随时干预——某个文件不符合预期，直接在 Composer 里说「这里不改，保持 JavaScript」。
Composer 的使用技巧
1. 描述要具体，范围要适中
范围太大，AI 会生成很多不需要的文件；范围太小，收益不明显。一个功能模块（5-15个文件）是最佳粒度。
2. 先看 diff 再采纳
Composer 生成的文件会显示 diff 对比。花 1 分钟快速扫一遍，确认逻辑没问题再 Apply，避免生成不符合预期的代码。
3. 配合 Git 分支使用
Composer 改动面大，建议在独立分支上操作。出了问题，一键回退，不影响主分支。
4. 不要完全放手
Composer Agent 模式很强，但它不了解你的业务逻辑。业务规则相关的改动，建议在 Chat 面板单独处理，不要全丢给 Composer。
什么时候用 Composer vs Chat vs Cmd+K？




场景


工具




改一段代码


Cmd+K




讨论方案 / 代码审查


Chat 面板




生成单个新文件


Cmd+K




一次生成或重构多个文件


Composer




自主决定要改哪些文件


Composer Agent 模式





下期预告：Cursor Settings 深度配置——如何调优 AI 行为，让它更懂你的项目。










🌟 关注我们，学习更多AI技能
🔗 https://agent.eake.cn/         
每周更新AI工具教程、Agent实战指南
我们尊重原创，主要目的在于分享信息。版权归原作者所有，如有侵犯您的权益请及时告知我们，我们将在第一时间删除您的作品。我们不对信息真实性负责，请各位看官慎重选择，更多信息请点击查看原文。