---
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="/zh-Hant/docs/cursor/official" />
  <Card title="從原理到實戰" description="按中文開發者學習順序理解 Cursor 工作流" href="/zh-Hant/docs/cursor/understanding" />
  <Card title="對比 Codex" description="理解 Cursor 和 Codex 的工作面差異" href="/zh-Hant/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)
