Cursor 中文教程
基于 Cursor 官方文档、Help Center 和 llms.txt 重写的 Cursor 中文教程。
Cursor 是 Anysphere 公司维护的 AI editor and coding agent（AI 编辑器 + 编程代理，官方当前定位）——它不是给现有 IDE 加 AI 插件，而是从一开始就把 Agent、Chat、Tab 补全、Rules、终端、diff review 集成到同一个编辑器里，让"读代码 → 改代码 → 跑命令 → 审 diff"在一个工作面闭环。本站把 Cursor 拆成两条路径：官方教程中文版负责查功能和边界，从原理到实战负责建立完整工作流。
flowchart LR
Start[Cursor 中文教程] --> Official[官方教程中文版]
Start --> Practice[从原理到实战]
Official --> Agent[Agent / Rules / MCP / CLI / Cloud]
Practice --> Workflow[真实项目工作流]阅读方式：先看判断和路径，再进入具体章节。Cursor 的资料变化很快，模型、价格、用量和企业策略以官方页面为准。
这套教程怎么用
Cursor 是编辑器形态的 AI 编程工具，优势在于贴近文件、上下文、diff、终端和团队代码库。学习时不要只看模型名字，先理解它怎样把 Agent、Rules、MCP、CLI、Cloud Agents（原 Background Agents）、Bugbot、Teams 和 Enterprise 能力连成工作流。
推荐顺序：
- 先读官方教程中文版，确认安装、Agent、Rules、MCP、CLI、Cloud 和企业能力的事实边界。
- 再读从原理到实战，理解如何把需求拆成 Cursor 能完成、能验证、能 review 的任务。
- 最后读工具对比页，把 Cursor、Codex、Claude Code、Windsurf 和 Copilot 的工作面分清。
适合解决什么
| 场景 | 为什么适合 Cursor | 不适合时怎么办 |
|---|---|---|
| 在已有代码库里持续迭代功能 | 编辑器自带项目索引和文件视图，Agent 改完立即看到 diff | 任务在云端长跑 → 走 Codex Cloud |
| 需要编辑器上下文 + 终端 + diff 紧密配合 | 三者在同一界面，信息不丢失 | 跨应用操作 → 走 Claude Code 或 Computer Use |
| 用 Rules 固化团队约定 | .cursor/rules 随仓库走，新成员拉下来即生效 | 规则要跨工具共用 → 改写为 AGENTS.md |
| 团队异步协作（Cloud Agents / Bugbot） | 异步任务回到 PR 与 review，可审计 | 公开教程事实核验 → 走人工 + 官方页 |
| 把个人使用升级成组织治理 | Teams / Enterprise 提供权限、配额、审计 | 全员只用补全 → Copilot 也能胜任 |
如果任务主要是云端后台长跑、跨应用操作、公开教程事实核验或发布流程，Cursor 不是唯一入口——应该和 Codex、Claude Code、CI 或发布工具配合，而不是强行把所有流程塞进编辑器。
学完后的交付标准
读完 Cursor 系列后，至少要能完成一个可审查的真实任务：
- 能说明该用 Chat、Agent、inline edit、terminal 还是 Cloud Agent。
- 能为项目写出清楚的 Rules。
- 能限制改动范围，避免 Agent 误改无关文件。
- 能要求 Cursor 跑测试、解释失败并修根因。
- 能把 Bugbot 或 PR review 结果转成可操作修复。
这也是本站把官方教程和原理实战分开的原因：官方教程回答“功能是什么”，原理实战回答“什么时候用、怎么验收、怎么避免误用”。
事实边界与维护原则
Cursor 的模型、订阅、企业策略、功能命名都在持续变化。本站只把相对稳定的工作流写进正文：选入口、给 Agent 上下文、写 Rules、配 MCP、审 diff、验证任务。高波动信息（具体模型 / 价格 / 套餐权益）以 Cursor Docs、Help Center 和 llms.txt 为准。
后续维护时优先补三类：
- 影响真实操作的能力变化（Agent、Rules、MCP、CLI、Cloud Agents、Bugbot）。
- 影响团队落地的配置变化（权限、组织策略、企业安全、审计）。
- 影响学习顺序的结构变化（官方文档重组、入口迁移）。
只影响营销文案、按钮位置或临时活动的信息——不进入核心教程。
读完应该能回答 3 个问题
读完 Cursor 系列后，你应该能：
- 当前任务为什么适合放在 Cursor——而不是 Codex Cloud 或 Claude Code。
- 项目规则应该写在哪里——才能让 Agent 每次都按团队标准行动。
- 一次修改完成后，如何用测试 / 终端输出 / diff / 人工 review 判断它真的可交付。
能答这三点，Cursor 才从"会补全的编辑器"变成可控工作流的一部分。
中文读者术语速查
Cursor 文档大量混用英文术语，本站尽量在首次出现时配中文解释。这里把全栏目最常见的英文术语集中说一次，遇到不熟悉的回这里查。
📖 通用工程术语（每篇都会用到）
| 英文 | 中文 | 一句话 |
|---|---|---|
prompt | 提示词 | 你给 AI 的自然语言指令 |
diff | 差异 / 变更对比 | Git 里"改了哪几行"的对照视图 |
repo / repository | 仓库 | 一个 Git 项目目录，含 .git |
branch | 分支 | Git 上一条独立开发线 |
commit | 提交 | 把变更打包成一个版本节点 |
PR / pull request | 拉取请求 | 把一个 branch 的改动申请合并到主线 |
review | 审查 / 代码审查 | 合并前由人或机器看 diff |
workspace | 工作区 | Cursor 当前打开的 folder 上下文 |
codebase | 代码库 | 一个项目的全部源码集合 |
session | 会话 | 一次连续对话的上下文 |
artifact | 产物 | 任务输出的可独立打开的对象（截图 / 视频 / 日志 / PR） |
metadata | 元数据 | 描述数据的数据（如 frontmatter） |
frontmatter | YAML 头部 | 文件最上方 --- 之间的元数据块 |
fallback | 回退方案 | 主路径失败时退回的备选方案 |
endpoint | 端点 | API / 服务的具体调用地址 |
payload | 负载 / 报文 | 请求或响应里携带的数据体 |
routing | 路由 | 决定请求 / 任务流向哪里 |
🤖 Cursor 产品术语（功能、能力包）
| 英文 | 中文 | 一句话 |
|---|---|---|
Agent | 代理 | Cursor 主交互模式，能读 / 改 / 跑 / 审 |
Plan Mode | 规划模式 | 复杂任务先出方案再写代码 |
Ask | 询问模式 | 只读理解，不改文件 |
Debug Mode | 排障模式 | 基于运行时证据定位 bug 根因 |
Tab | 标签 / 补全 | 局部代码补全 |
Cloud Agents | 云端代理 | 隔离 VM 里跑的异步代理（原 Background Agents） |
Bugbot | bug 机器人 | 自动 PR review |
Composer 2 | Composer 2 | Cursor 自研模型（不是模式） |
Rules | 规则 | 项目长期 AI 指令，进 Git |
Skills | 技能 | 多步可复用工作流包 |
Subagents | 子代理 | 独立上下文的专门代理 |
Hooks | 钩子 | 固定事件上自动跑的脚本 |
Plugins | 插件 | 把 Rules / Skills / MCP / Hooks 打包分发 |
Worktrees | 工作树 | git 把一个仓库 checkout 到多个独立目录 |
Checkpoints | 快照 | Agent 改前自动存的本地回退点 |
Marketplace | 市场 | 官方插件发布平台 |
Source Control | 源代码控制视图 | 编辑器里看完整未提交 diff 的视图 |
🔧 工具协议与执行环境术语
| 英文 | 中文 | 一句话 |
|---|---|---|
MCP | 模型上下文协议 | Model Context Protocol，让 agent 接外部工具的协议 |
ACP | 代理客户端协议 | Agent Client Protocol，把 Cursor Agent 接进第三方编辑器 |
CLI | 命令行工具 | Command-Line Interface |
headless | 无界面 / 非交互 | 脚本和 CI 里运行，不进 REPL |
print mode | 打印模式 | agent -p，输出到 stdout |
--yolo | 跳过所有确认 | "you-only-live-once" |
sandbox | 沙箱 | 限制进程能访问的文件 / 网络范围 |
allowlist | 白名单 | 明确允许的命令清单 |
blocklist / denylist | 黑名单 / 阻止清单 | 明确禁止的命令清单 |
runtime | 运行时 | 代码运行的环境（local / cloud / VM） |
VM | 虚拟机 | virtual machine，云端隔离环境 |
transport | 传输方式 | MCP 通信方式（stdio / SSE / Streamable HTTP） |
stdio | 标准输入输出 | 进程间通过 stdin / stdout / stderr 通信 |
SSE | 服务端推送 | Server-Sent Events |
OAuth | 开放授权协议 | 第三方应用代用户访问资源的标准 |
API key | API 密钥 | 程序化访问凭据 |
instrumentation | 插桩 | 临时插日志 / 断点观察运行时 |
formatter | 格式化工具 | Prettier / Black 等自动整理代码 |
linter | lint 工具 | 静态扫描代码风格和潜在问题 |
regression | 回归 bug | 过去能工作、新版坏了的问题 |
🏢 团队 / 企业治理术语
| 英文 | 中文 | 一句话 |
|---|---|---|
SSO | 单点登录 | Single Sign-On |
SAML | 安全声明标记语言 | SSO 的主流协议之一 |
SCIM | 跨域身份同步标准 | System for Cross-domain Identity Management，企业自动管账号生命周期 |
JIT | 即时配置 | Just-In-Time provisioning，登录即创建账号 |
RBAC | 基于角色的访问控制 | Role-Based Access Control |
MFA | 多因素认证 | Multi-Factor Authentication |
MDM | 移动设备管理 | Mobile Device Management，统一下发设备策略 |
IdP | 身份提供方 | Identity Provider（如 Okta / Azure AD） |
Privacy Mode | 隐私模式 | 模型供应商不存 / 不训练你的数据 |
ZDR | 零数据保留 | Zero Data Retention，请求后立即删除 |
BAA | 业务伙伴协议 | Business Associate Agreement，HIPAA 合规要件 |
DPA | 数据处理协议 | Data Processing Agreement，GDPR 合规要件 |
SIEM | 安全信息与事件管理 | 集中收集和分析安全日志的平台 |
SAST | 静态应用安全测试 | 不运行代码的安全扫描 |
DLP | 数据防泄漏 | Data Loss Prevention |
PII | 个人可识别信息 | Personally Identifiable Information |
audit log | 审计日志 | 谁在何时做了什么的不可篡改记录 |
后续每篇文章里出现的英文术语，会在首次使用时给一次简短中文括注，如果想要更完整解释，回这里查表。