---
title: "Cursor 中文教程"
description: "基于 Cursor 官方文档、Help Center 和 llms.txt 重写的 Cursor 中文教程。"
verifiedAt: "2026-05-09"
---

Cursor 是 Anysphere 公司维护的 **AI editor and coding agent**（AI 编辑器 + 编程代理，官方当前定位）——它不是给现有 IDE 加 AI 插件，而是从一开始就把 Agent、Chat、Tab 补全、Rules、终端、diff review 集成到同一个编辑器里，让"读代码 → 改代码 → 跑命令 → 审 diff"在一个工作面闭环。本站把 Cursor 拆成两条路径：官方教程中文版负责查功能和边界，从原理到实战负责建立完整工作流。

```mermaid
flowchart LR
  Start[Cursor 中文教程] --> Official[官方教程中文版]
  Start --> Practice[从原理到实战]
  Official --> Agent[Agent / Rules / MCP / CLI / Cloud]
  Practice --> Workflow[真实项目工作流]
```

> [!NOTE]
> **阅读方式**：先看判断和路径，再进入具体章节。Cursor 的资料变化很快，模型、价格、用量和企业策略以官方页面为准。

<Cards>
  <Card title="官方教程中文版" description="按 Cursor 官方能力域重写的中文查询手册" href="/docs/cursor/official" />
  <Card title="从原理到实战" description="按中文开发者学习顺序理解 Cursor 工作流" href="/docs/cursor/understanding" />
  <Card title="对比 Codex" description="理解 Cursor 和 Codex 的工作面差异" href="/docs/cursor/understanding/11-cursor-vs-codex-claude-windsurf-copilot" />
</Cards>

## 这套教程怎么用

Cursor 是编辑器形态的 AI 编程工具，优势在于贴近文件、上下文、diff、终端和团队代码库。学习时不要只看模型名字，先理解它怎样把 Agent、Rules、MCP、CLI、Cloud Agents（原 Background Agents）、Bugbot、Teams 和 Enterprise 能力连成工作流。

推荐顺序：

1. 先读官方教程中文版，确认安装、Agent、Rules、MCP、CLI、Cloud 和企业能力的事实边界。
2. 再读从原理到实战，理解如何把需求拆成 Cursor 能完成、能验证、能 review 的任务。
3. 最后读工具对比页，把 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](https://cursor.com/docs)、[Help Center](https://cursor.com/help) 和 [llms.txt](https://cursor.com/llms.txt) 为准。

后续维护时优先补三类：

- 影响真实操作的能力变化（Agent、Rules、MCP、CLI、Cloud Agents、Bugbot）。
- 影响团队落地的配置变化（权限、组织策略、企业安全、审计）。
- 影响学习顺序的结构变化（官方文档重组、入口迁移）。

只影响营销文案、按钮位置或临时活动的信息——不进入核心教程。

## 读完应该能回答 3 个问题

读完 Cursor 系列后，你应该能：

1. 当前任务**为什么适合放在 Cursor**——而不是 Codex Cloud 或 Claude Code。
2. 项目规则**应该写在哪里**——才能让 Agent 每次都按团队标准行动。
3. 一次修改完成后，**如何用测试 / 终端输出 / diff / 人工 review 判断它真的可交付**。

能答这三点，Cursor 才从"会补全的编辑器"变成可控工作流的一部分。

## 中文读者术语速查

Cursor 文档大量混用英文术语，本站尽量在首次出现时配中文解释。这里把全栏目最常见的英文术语集中说一次，遇到不熟悉的回这里查。

<details>
<summary>📖 通用工程术语（每篇都会用到）</summary>

| 英文 | 中文 | 一句话 |
|------|------|--------|
| `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` | 路由 | 决定请求 / 任务流向哪里 |

</details>

<details>
<summary>🤖 Cursor 产品术语（功能、能力包）</summary>

| 英文 | 中文 | 一句话 |
|------|------|--------|
| `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 的视图 |

</details>

<details>
<summary>🔧 工具协议与执行环境术语</summary>

| 英文 | 中文 | 一句话 |
|------|------|--------|
| `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 | 过去能工作、新版坏了的问题 |

</details>

<details>
<summary>🏢 团队 / 企业治理术语</summary>

| 英文 | 中文 | 一句话 |
|------|------|--------|
| `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` | 审计日志 | 谁在何时做了什么的不可篡改记录 |

</details>

后续每篇文章里出现的英文术语，会在首次使用时给一次简短中文括注，如果想要更完整解释，回这里查表。

## 官方来源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
