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 | 審計日誌 | 誰在何時做了什麼的不可篡改記錄 |
後續每篇文章裡出現的英文術語，會在首次使用時給一次簡短中文括注，如果想要更完整解釋，回這裡查表。