这是一份关于 Cursor AI 代码编辑器核心功能和高效工作流的详细分享笔记，旨在帮助您快速掌握这款 AI 优先的开发工具。
--------------------------------------------------------------------------------
Cursor AI 编辑器核心工作模式与最佳实践分享笔记
Cursor AI 编辑器是基于 Visual Studio Code (VS Code) 分支开发的专有 IDE，其核心定位是AI-First (AI 优先)，旨在将 AI 深度集成到编码工作流的每一个环节。
I. 核心 AI 工作模式
Cursor 提供了三种主要模式来处理不同复杂度的任务：
模式名称 | 特点 | 适用场景 | 快捷键 |
Ask 模式(内联编辑/Inline Edit) | 快速、局部修改。AI 会智能识别选定代码的周围上下文。 | 1.局部重构：如将函数重构为纯函数，或添加 JSDoc 文档。2.小型原型：快速填充函数签名或添加 TypeScript 类型。3.批量编辑：结合多光标功能（Cmd+D）对重复代码模式进行批量转换。 | Cmd+K(macOS) /Ctrl+K(Windows/Linux) |
Agent 模式(自主智能体) | 复杂、多步骤、跨文件的任务。能够自主地制定计划、运行终端命令、读写文件并进行自我修正。 | 1.多文件重构：如在整个代码库中重命名变量或结构性代码变更。2.自动化修复：运行 | ⌘.或侧边栏聊天 |
Plan 模式(结构化规划) | 预先规划的工作流。Agent 在执行任务前生成详细、分解的步骤计划。 | 1.大型功能实现：强制 Agent 在开始大规模重构前制定高效的执行路径。2.任务分解和审计：允许开发者在 AI 开始编码前检查和修改计划，减少意外的大范围更改。 | Agent 模式下的选项 |
Debug 模式(复杂 Bug 诊断) | 专注于重现和修复棘手的 Bug。 | 通过在应用程序中插入运行时日志，进行假设生成和运行时分析，以诊断跨堆栈、语言和模型的复杂问题。 | v2.2 版本新增功能 |
--------------------------------------------------------------------------------
II. 关键技术和发展亮点（截至 2025 年底）
1. 核心模型：Composer
Cursor 2.0 版本（2025 年 10 月发布）引入了其首个专有 Agent 编码模型Composer。
•速度优势：Composer 旨在提升软件工程的智能和速度，声称比同等智能模型快4 倍。
•训练特点：Composer 通过强化学习进行训练，使其能够更有效地进行并行工具调用、使用搜索和文件读取工具。
2. 代码库理解和上下文管理
Cursor 通过复杂的技术来理解大型代码库，克服 LLM 上下文窗口的限制。
•语义分块：Cursor 使用tree-sitter进行语言无关的代码解析，将文件拆分为有意义的单元（函数、类、模块，称为“语义分块”）。
•@-提及控制：开发者可以使用@提及功能精确控制提供给 AI 的上下文，例如@file(包含特定文件)、@folder(包含目录) 或@docs(包含外部文档)。
3. 增强功能
•多智能体裁决（Multi-Agent Judging）：在 v2.2 版本中引入，当多个 Agent 并行运行时，Cursor 会自动评估所有结果并推荐最佳解决方案，并附带解释。
•浏览器集成：Agent 模式现在可以控制浏览器（v2.0 GA），能够抓取屏幕截图、调试客户端问题，并且可以将 DOM 元素的信息传递给 Agent，以进行有针对性的 UI/样式修改。
--------------------------------------------------------------------------------
III. 提高效率的最佳实践（Vibe Coding 规则）
为了最大限度地提高使用 Cursor 的效率，开发者需要转变工作方式，专注于管理 AI 的上下文和边界。
1. 上下文和指令治理
实践名称 | 描述 | 目的 | 依据 |
项目规则（.cursorrules） | 创建 | 充当 AI 的项目工程手册，确保生成代码的质量和一致性。 | |
任务分解 (PRD/RFC) | 将复杂的更改分解为更小、可管理的RFC（意见征求稿）或功能文档，每次只让 Agent 实施一个特定的 RFC。 | 为 AI 提供清晰的边界和集中的指导，防止其在大型代码库中“迷失”或做出不必要的更改。 | |
精确提示 | 使用 | 减少延迟，提高 AI 建议的相关性，同时节省 tokens。 |
2. 工作流加速技巧
•TDD 优先：对于非简单任务，要求 AI先编写测试，然后编写代码，并迭代直到所有测试通过。这能保证 AI 工作的正确性和鲁棒性。
•YOLO 模式/自动修复：开启 YOLO 模式（通过 Agent 提示或设置），允许 Agent 自动运行测试、构建命令（如tsc），并在发现构建错误后自动修复，直到通过。
•错误日志分析：当遇到棘手问题时，指示 Agent添加日志语句，然后运行代码并将日志输出粘贴给 Agent 进行分析，让其基于运行时行为而非静态分析来提出修复建议。
•频繁提交：定期将进度推送到 GitHub。请记住，Cursor 的 **检查点（Checkpoint）**功能仅记录由 AI Agent 创建的更改，不会保存手动编辑。
4. 效率快捷键精选
快捷键 | 功能描述 |
Cmd/Ctrl + K | Ask 模式 (内联编辑)：对选中代码进行快速修改或生成。 |
Cmd/Ctrl + L | 打开侧边栏 AI 聊天。 |
Cmd + . | 代码操作 (Code actions)：调出快速修复建议。 |
Cmd + P | 快速打开文件：高频使用的文件跳转快捷键。 |
Cmd + D | 多光标：选择下一个匹配项，常与 Ask 模式结合进行批量修改。 |
Tab | 接受 AI 的代码建议或补全。 |
