---
title: "Windsurf 官方教程中文版"
description: "按 Windsurf 官方文件能力域重組的中文查詢手冊，覆蓋安裝、Cascade、上下文、MCP、Skills、模型和團隊控制。"
verifiedAt: "2026-05-09"
---

這一組不是逐字翻譯，而是把 Windsurf 官方文件重組成中文開發者能直接查、直接落地的教程。事實邊界來自 Windsurf / Cognition 官方資料和 MCP 官方規範；模型、價格、用量、計劃、企業控制這類高波動事實，只寫查詢入口和決策邊界。

> [!NOTE]
> **先給結論**：個人上手按“安裝 → Cascade → 上下文 → 終端”讀；團隊上線按“MCP → Skills/Workflows → 模型用量 → 團隊控制”補齊治理。

## 閱讀入口

<Cards>
  <Card title="安裝與首次啟動" description="下載、登入、匯入 VS Code/Cursor 配置，確認 PATH 和第一次只讀驗證。" href="/zh-Hant/docs/windsurf/official/00-setup-onboarding" />
  <Card title="Cascade 核心能力" description="理解 Code/Chat、計劃、佇列、工具呼叫、checkpoint、revert 和多會話。" href="/zh-Hant/docs/windsurf/official/01-cascade-core" />
  <Card title="上下文與規則" description="區分 Memories、Rules、AGENTS.md、Workflows、Skills 和 .codeiumignore。" href="/zh-Hant/docs/windsurf/official/02-context-rules-agents" />
  <Card title="終端與命令控制" description="設定 Command、auto-execution、allow/deny list、團隊命令策略和 dedicated terminal。" href="/zh-Hant/docs/windsurf/official/03-terminal-command-control" />
  <Card title="MCP 整合" description="使用 Marketplace、mcp_config.json、HTTP/SSE、認證插值、tools 限制和企業 registry。" href="/zh-Hant/docs/windsurf/official/04-mcp-integration" />
  <Card title="Skills、Workflows 與 Hooks" description="判斷什麼時候寫 Skill、Workflow、Hook，什麼時候只用 Rule 或 AGENTS.md。" href="/zh-Hant/docs/windsurf/official/05-skills-workflows" />
  <Card title="模型、Adaptive 與用量" description="理解 Adaptive、SWE 模型族、BYOK、quota、extra usage 和團隊模型策略。" href="/zh-Hant/docs/windsurf/official/06-models-usage" />
  <Card title="團隊控制與排障" description="梳理 Admin Portal、SSO/SCIM、RBAC、命令、MCP、共享、日誌和常見故障。" href="/zh-Hant/docs/windsurf/official/07-teams-troubleshooting" />
</Cards>

## 學習路徑

```mermaid
flowchart TD
    Start["第一次上手"] --> Setup["安裝與首次啟動"]
    Setup --> Cascade["Cascade 核心能力"]
    Cascade --> Context["上下文與規則"]
    Context --> Terminal["終端與命令控制"]
    Terminal --> Use{"個人使用還是團隊上線?"}
    Use -->|個人繼續進階| Models["模型、Adaptive 與用量"]
    Use -->|團隊上線| MCP["MCP 整合"]
    MCP --> Skills["Skills 與 Workflows"]
    Skills --> Models
    Models --> Team["團隊控制與排障"]

    style Cascade fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Terminal fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Team fill:#fee2e2,stroke:#dc2626,stroke-width:2px
```

## 官方事實源

| 主題 | 官方來源 |
| --- | --- |
| 安裝與 onboarding | [Welcome to Windsurf](https://docs.windsurf.com/windsurf/getting-started) |
| Cascade | [Cascade Overview](https://docs.windsurf.com/windsurf/cascade/cascade) |
| Memories / Rules / AGENTS.md | [Memories & Rules](https://docs.windsurf.com/windsurf/cascade/memories)、[AGENTS.md](https://docs.windsurf.com/windsurf/cascade/agents-md) |
| Terminal | [Terminal](https://docs.windsurf.com/windsurf/terminal) |
| MCP | [Model Context Protocol (MCP)](https://docs.windsurf.com/windsurf/cascade/mcp)、[MCP Specification](https://modelcontextprotocol.io) |
| Skills / Workflows | [Skills](https://docs.windsurf.com/windsurf/cascade/skills)、[Workflows](https://docs.windsurf.com/windsurf/cascade/workflows) |
| Models / Usage | [AI Models](https://docs.windsurf.com/windsurf/models)、[Adaptive](https://docs.windsurf.com/windsurf/adaptive)、[Quota-Based Usage](https://docs.windsurf.com/windsurf/accounts/quota) |
| Teams / Troubleshooting | [Guide for Admins](https://docs.windsurf.com/windsurf/guide-for-admins)、[Common Windsurf Issues](https://docs.windsurf.com/troubleshooting/windsurf-common-issues) |
| 全量索引 | [Windsurf llms.txt](https://docs.windsurf.com/llms.txt) |

## 查閱順序

如果你只想把 Windsurf 跑起來：

1. [安裝與首次啟動](/zh-Hant/docs/windsurf/official/00-setup-onboarding)
2. [Cascade 核心能力](/zh-Hant/docs/windsurf/official/01-cascade-core)
3. [上下文、規則與 AGENTS.md](/zh-Hant/docs/windsurf/official/02-context-rules-agents)
4. [終端與命令控制](/zh-Hant/docs/windsurf/official/03-terminal-command-control)

如果你要把 Windsurf 接進團隊流程：

1. [MCP 整合](/zh-Hant/docs/windsurf/official/04-mcp-integration)
2. [Skills 與 Workflows](/zh-Hant/docs/windsurf/official/05-skills-workflows)
3. [模型、Adaptive 與用量](/zh-Hant/docs/windsurf/official/06-models-usage)
4. [團隊控制與排障](/zh-Hant/docs/windsurf/official/07-teams-troubleshooting)

## 術語口徑

| 術語 | 本系列中的用法 |
| --- | --- |
| Windsurf | IDE 產品本體 |
| Cascade | Windsurf 內的 agentic AI assistant |
| Rules | 持久行為規則，可全域性、workspace、system 級配置 |
| AGENTS.md | 目錄範圍規則，進入 Cascade 同一套 Rules engine |
| Workflows | 手動 slash command 呼叫的多步流程 |
| Skills | 帶 `SKILL.md`、指令碼、模板、資源的能力包 |
| MCP | Model Context Protocol，用於把外部工具和服務接給 Cascade |
| Adaptive | Cognition 的智慧模型路由，由 Windsurf 根據任務選擇底層模型 |

<details>
<summary>深讀：為什麼官方教程要和實戰教程分層</summary>

官方教程負責事實邊界：路徑、入口、限制、官方建議、企業控制和排障來源。實戰教程負責把這些事實組合成真實專案方法，比如第一次只讀驗證、命令 deny list、MCP 准入、Skill 目錄策略和模型預算控制。

這兩層不能混在一起。官方事實會變化，所以每篇都保留核驗日期和官方來源；實戰經驗會沉澱成判斷規則，但不能覆蓋官方頁面裡的最新價格、模型和企業功能狀態。
</details>

## 本組自檢

讀完整組後，用這 4 個問題檢查：

1. 你能否在新機器上完成安裝、登入、PATH 和第一次只讀 Cascade 驗證？
2. 你能否區分 Memories、Rules、AGENTS.md、Workflows、Skills 和 MCP？
3. 你能否給真實儲存庫設定終端 allow/deny list 和 `.codeiumignore`？
4. 你能否為團佇列出模型、命令、MCP、共享、SSO/SCIM 和排障的上線清單？

透過標準：你能把 Windsurf 作為一個可治理的 AI IDE 使用，而不是隻把它當作聊天側欄。
