---
title: "Windsurf 中文教程"
description: "基於 Windsurf 官方文件、Cognition 官方公告和 MCP 規範重寫的 Windsurf 中文教程。"
verifiedAt: "2026-05-09"
---

Windsurf 是 Cognition 旗下的 agentic IDE。它不是把聊天框塞進編輯器，而是把 Cascade、程式碼索引、終端、規則、MCP、工作流和團隊控制放在同一個開發介面裡，讓 AI 能圍繞一個真實程式碼庫持續讀、改、跑、驗證。

> [!NOTE]
> **先給結論**：如果你想把 AI 放進日常 IDE 工作流，Windsurf 值得學；如果你已經主要用 Claude Code 或 Codex 做終端任務，Windsurf 更適合承擔“編輯器內連續開發”和“程式碼上下文協作”這一層。

## 兩條互補路徑

```mermaid
flowchart LR
    Start["Windsurf 中文教程"] --> Official["官方教程中文版"]
    Start --> Understanding["從原理到實戰"]
    Official --> Lookup["安裝 / Cascade / Context / MCP / Rules / Usage"]
    Understanding --> Judgment["定位 / 工作流 / 安全 / 團隊 / 對比"]

    style Start fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Official fill:#dcfce7,stroke:#22c55e
    style Understanding fill:#fef3c7,stroke:#f59e0b
```

<Cards>
  <Card title="官方教程中文版" description="按 Windsurf 官方能力域重組，適合查安裝、Cascade、上下文、MCP、規則、工作流、模型與用量。" href="/zh-Hant/docs/windsurf/official" />
  <Card title="從原理到實戰" description="8 篇中文講解，理解 Windsurf 如何進入真實專案、如何和 Codex / Claude Code / Cursor 分工。" href="/zh-Hant/docs/windsurf/understanding" />
</Cards>

## 怎麼選擇閱讀路徑

| 你的狀態 | 先讀什麼 | 目標 |
| --- | --- | --- |
| 還沒安裝 | [官方教程中文版](/zh-Hant/docs/windsurf/official) | 跑通安裝、登入、匯入配置和第一輪 Cascade 對話 |
| 能開啟 Cascade，但不會穩定使用 | [第一次專案閉環](/zh-Hant/docs/windsurf/understanding/02-first-project-loop) | 用只讀、單檔案編輯、驗證三步建立安全節奏 |
| 想讓它記住專案規則 | [上下文、規則與 AGENTS.md](/zh-Hant/docs/windsurf/understanding/04-context-rules-agents-md) | 區分 Memories、Rules、AGENTS.md 和 `.codeiumignore` |
| 想接外部工具 | [MCP、Skills 與 Workflows](/zh-Hant/docs/windsurf/understanding/05-mcp-skills-workflows) | 判斷什麼放 MCP，什麼寫成 workflow，什麼沉澱為 skill |
| 準備團隊使用 | [終端與命令安全](/zh-Hant/docs/windsurf/understanding/06-terminal-command-safety) | 設定 auto-execution、allow/deny list、管理員上限和金鑰邊界 |

> [!IMPORTANT]
> **不要只把 Windsurf 當 Cursor 替代品**。它真正值得拆的是 Cascade 如何拿到上下文、如何執行命令、如何沉澱規則，以及哪些動作必須繼續人工確認。

## 官方來源

- Windsurf 官方文件：[https://docs.windsurf.com/windsurf/getting-started](https://docs.windsurf.com/windsurf/getting-started)
- Cascade 文件：[https://docs.windsurf.com/windsurf/cascade/cascade](https://docs.windsurf.com/windsurf/cascade/cascade)
- 官方文件索引：[https://docs.windsurf.com/llms.txt](https://docs.windsurf.com/llms.txt)
- Cognition 收購公告：[https://cognition.ai/blog/windsurf](https://cognition.ai/blog/windsurf)
- Windsurf 更新記錄：[https://windsurf.com/changelog](https://windsurf.com/changelog)

## 使用前的安全提醒

Windsurf 能讀專案、改檔案、執行命令、接 MCP、儲存規則，也能在團隊環境裡被管理員集中控制。進入真實專案時按低風險順序推進：

1. 第一輪任務只讀：讓 Cascade 解釋專案結構和關鍵路徑。
2. 第一次寫操作限定單檔案，並要求說明修改原因。
3. 多檔案任務先讓它產出計劃，再分批執行。
4. 命令自動執行先用 allowlist only，不直接開 Turbo。
5. MCP 金鑰只走環境變數或檔案插值，不寫進 `mcp_config.json`。
6. 分享對話、提交程式碼、部署、刪除資料前必須人工確認。

## 引流出口

- Aaron工作流主站：[xiangyugongzuoliu.com](https://xiangyugongzuoliu.com)
- AI 程式設計實操課：[課程頁](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
