Cursor 产品定位
从 Cursor 官方文档理解它为什么是 AI editor and coding agent，而不是普通 IDE 插件。
Cursor 官方文档把它当前定义为 AI editor and coding agent（之前曾自称 AI-native code editor，已升级为更具体的双层定位）：Cursor 既是你日常写代码的编辑器，也是能理解代码库、计划功能、修 bug、审查变更并连接现有工具的 coding agent。
所以学习 Cursor 不应该只从“聊天窗口在哪”开始。你要先建立一张能力地图：理解代码、计划和构建功能、查 bug、审 diff、定制上下文、连接团队工作流。
阅读目标：读完本章，你应该能解释 Cursor 和“VS Code + AI 插件”的区别，并知道后续为什么要围绕 Agent、Rules、MCP、CLI、Cloud Agent 和团队治理学习。
1. 官方定义里的两层身份
Cursor 官方首页文档写得很直接：Cursor is an AI editor and coding agent.
这可以拆成两层：
| 身份 | 意味着什么 | 学习重点 |
|---|---|---|
| AI editor | 仍然是日常代码编辑器，保留文件、扩展、终端、Git 等工作面 | 安装、迁移、快捷键、插件、Tab、inline edit |
| Coding agent | 能围绕代码库完成任务，而不是只补一段代码 | Agent、Plan Mode、review、tools、Rules、MCP、Cloud Agent |
普通插件通常只增强已有 IDE 的某个入口；Cursor 的产品重心是把 AI 工作流放进编辑器核心。
2. Cursor 能做什么
官方文档把能力分成几个方向。
| 官方能力域 | 中文理解 |
|---|---|
| Understand your code | 读代码库、找入口、解释模块关系 |
| Plan and build features | 规划功能、用 Plan Mode 控制较大改动 |
| Find and fix bugs | 复现问题、定位根因、验证修复 |
| Review changes | 看 diff、跑检查、合并前发现问题 |
| Customize Cursor | 用 rules、skills、prompts 匹配团队工作方式 |
| Connect your workflow | 接 GitHub、GitLab、JetBrains、Xcode、Slack、Linear、Deeplinks 等（详见 § 05-integrations-sdk） |
flowchart TD
Cursor["Cursor"] --> Editor["AI Editor"]
Cursor --> Agent["Coding Agent"]
Editor --> Local["文件 / 终端 / Git / 扩展"]
Agent --> Understand["理解代码库"]
Agent --> Plan["规划和构建功能"]
Agent --> Fix["查 bug 和修复"]
Agent --> Review["审查变更"]
Agent --> Connect["连接团队工具"]3. Cursor 不等于自动放权
Cursor 可以读文件、写代码、跑命令、使用浏览器、接 MCP 和外部集成。能力越多，越需要边界。
真实项目里，先回答：
- 它需要看哪些文件？
- 它能不能运行 terminal 命令？
- 它是否需要浏览器或外部网页？
- 它是否会接触密钥、账号、账单或生产系统？
- 结果用什么验证：diff、test、browser、PR 还是后台状态？
不要把 Cursor 当成“更聪明的自动改代码工具”。它真正适合的是可计划、可审查、可验证、可回退的开发任务。
4. 推荐学习顺序
第一次系统学习，按这个顺序：
- 安装、登录、打开第一个低风险项目。
- 让 Cursor 只读解释代码库。
- 做一个小改动并审 diff。
- 学 Agent、Plan Mode、review 和 tools。
- 学 Rules、MCP、Skills、Subagents、Hooks。
- 学 CLI、Headless 和 GitHub Actions。
- 学 Cloud Agent、Bugbot、团队与企业治理。
深读：为什么不要从模型列表开始学 Cursor
Cursor 官方文档确实有很长的模型列表，而且模型、上下文、Max Mode、价格和隐藏状态变化很快。但如果一开始就围绕模型学，很容易忽略 Cursor 的核心工作流：代码库上下文、Agent 计划、工具调用、diff review 和团队策略。
模型影响能力上限，工作流决定结果能不能上线。教程里应该教“什么时候查官方模型页”，而不是把某一天的模型表当成教程主体。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Cursor 官方定义里的 “AI editor” 和 “coding agent” 分别强调什么？
- 为什么 Cursor 不是普通 IDE 旁边加一个聊天侧栏？
- 一个真实项目任务交给 Cursor 前，至少要先定义哪些边界？
通过标准：你能把 Cursor 的学习路径解释成“编辑器工作面 + Agent 任务闭环 + 团队治理”，而不是只说模型或聊天。
官方来源
- Cursor Documentation —— 官方定义 Cursor 是 AI editor and coding agent，并列出理解代码、构建功能、修 bug、审查、定制和连接工作流等能力域。
- Cursor llms.txt —— Cursor 官方文档索引，用于核对所有能力页和 Help Center 页。