Cursor Composer 教程：从入门到工程化

Composer 是什么、为什么重要

Cursor Composer 是 2024 年下半年新增的 Agent Mode，它把 Cursor 从「单文件 AI 辅助」推到了「多文件 AI 协同改造」的层级。

简单说：Tab 是补全、Cmd+K 是单点改写、Chat 是问答，Composer 是「描述任务 → Agent 跑完整流程」。这是 Cursor 与 Claude Code 在 Agentic 能力上的对齐之作。

Composer vs Tab vs Cmd+K vs Chat 对比

1. Tab 补全：行内、被动、最快；适合写惯例代码、补完已有模式
2. Cmd+K 改写：选段、主动、单文件；适合改一段代码、重命名、加错误处理
3. Chat（普通问答）：对话、不直接改代码；适合理解项目、查文档、debug
4. Composer Agent Mode：自然语言任务、多文件协同、半自动；适合新需求、跨文件重构、批量改造

4 类典型 Composer 应用场景

1. 多文件改造：给一个 API 接口加 OpenAPI 注释 → Composer 会同时改 controller、DTO、route 定义
2. 新需求开发：从产品需求一句话开始 → Composer 创建 service / model / migration / test 全套骨架
3. 代码迁移：把一个组件从 class 改 hooks、把一段 callback 改 async/await → Composer 跨文件追踪所有引用一起改
4. Bug 复现：贴一段错误堆栈 + 业务描述 → Composer 读相关代码、写复现测试、提出修法

写好 Composer Prompt 的 5 个实战技巧

1. 明确边界：「只改 src/api 目录下的文件，不要动 tests」
2. 给参考：「参考 user.controller.ts 的风格写一个 product.controller.ts」
3. 列验收点：「改完后：1) 所有路由必须有 Swagger 注释 2) 必须返回统一 Response 类型」
4. 分步走：「先列出会改哪些文件，让我确认后再改」
5. 禁忌项：「不要修改数据库 schema、不要改环境变量」

常见踩坑

• Context 漂移：Composer 跑大任务时上下文丢失 → 中途分段确认，每 3-5 次操作让它总结一次
• 风格不一致：没设 Custom Rules → Composer 会按 AI 默认风格生成，与团队代码不统一
• 静默失败：Composer 改了文件没运行测试 → 让 Composer 跑测试 + 给你结果再说改完
• 过度自信：Composer 说「完成」不等于「正确」→ 必须自己 Review，尤其涉及业务逻辑

红烁 AI 的 Cursor 培训会把这 5 类技巧 + 4 类避坑都演示一遍，并基于你团队的真实代码做练习。

→ Cursor 培训详情 · → AI 编程规则模板 · → 企业内训方案

红烁四大解决方案

业务、研发、管理三线一体落地