Cursor Composer 最佳实践-开发者社区

Cursor Composer 最佳实践（2026年最新）是 Cursor 最强大的“杀手级”功能，用于多文件编辑、自治 Agent 任务和复杂变更。它本质上是 AI 驱动的“多文件 Agent”，能规划、编辑、运行命令并迭代。

1. 基础操作与快捷键

打开 Composer：Cmd + I（Mac） /Ctrl + I（Win/Linux）。这是多文件任务入口。
全屏/增强模式：Cmd + Shift + I。
模式切换：
- Normal 模式：AI 提出变更，你手动审查 Accept（更安全，适合精细控制）。
- Agent 模式（推荐多数场景）：AI 自主规划、编辑文件、运行终端命令、修复错误（自治性强，但需监督）。
Checkpoint（时间旅行）：每次重大步骤自动快照。出错时回滚到之前状态，非常实用。

快捷键组合：

Cmd + K：Inline Edit（单文件快速修改）。
Cmd + L：Chat（解释、调试）。
Composer 内用@引用上下文。

2. Prompt 工程最佳实践（最重要）

Composer 的效果高度依赖 Prompt 质量。把它当作“写规格说明书”，而非随意聊天。

✅ 优秀 Prompt 示例：

Implement a login route: - @user_model.ts @auth_service.ts @routes.json - Use Zod for validation - Match error format in @errors.ts - Create unit test in tests/auth/ - Follow existing architecture patterns (reference @README.md) - Ensure rate limiting and security best practices

核心技巧：

具体 + 结构化：列出要求、引用文件/符号、指定约束（风格、库、测试）。
提供上下文：用@file、@folder、@codebase、@docs（如@docs react-hook-form）。
分步迭代：不要一次性要求大功能。先“创建骨架 + 占位数据”，测试通过后再“实现具体逻辑”。
指定输出：要求“输出完整文件”（防懒惰占位符）、“创建 plan.md 先”、 “运行测试并修复”。
错误修复：复制终端/TS 错误直接贴入 Composer，AI 通常能快速修复。

3. 工作流最佳实践

Always Commit First：用 Git 提交当前状态（git commit -m "checkpoint before composer"）。Agent 可能删改文件，Checkpoint + Git 是双保险。
单任务原则：一个 Composer 会话专注一个明确任务。任务完成或卡住时，新建会话（防止上下文污染）。
Plan → Critique → Execute：
- 先让强大模型（如 Claude Opus）生成计划。
- Review 计划。
- 用 Composer（或 Cursor Composer 1.5/2.x）执行。
Review Diff：始终逐行审查变更，不要盲 Accept。理解代码才能长期维护。
YOLO Mode（设置中开启）：允许 Agent 自主运行命令/删文件（生产力高，但高风险，仅信任时用）。
TDD / 测试驱动：先让 AI 写测试 → Review → 再实现通过测试的代码。
规则系统（强力推荐）：
- 项目根目录创建.cursorrules或.cursor/rules/*.mdc文件，定义风格、架构、禁止事项（例如“始终用 functional components + Hooks”、“每个函数必须有单元测试”）。
- 全局 Rules for AI（设置中）放通用偏好。