Windsurf 中文教程
基於 Windsurf 官方文件、Cognition 官方公告和 MCP 規範重寫的 Windsurf 中文教程。
Windsurf 是 Cognition 旗下的 agentic IDE。它不是把聊天框塞進編輯器，而是把 Cascade、程式碼索引、終端、規則、MCP、工作流和團隊控制放在同一個開發介面裡，讓 AI 能圍繞一個真實程式碼庫持續讀、改、跑、驗證。
先給結論：如果你想把 AI 放進日常 IDE 工作流，Windsurf 值得學；如果你已經主要用 Claude Code 或 Codex 做終端任務，Windsurf 更適合承擔“編輯器內連續開發”和“程式碼上下文協作”這一層。
兩條互補路徑
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官方教程中文版
按 Windsurf 官方能力域重組，適合查安裝、Cascade、上下文、MCP、規則、工作流、模型與用量。
從原理到實戰
8 篇中文講解，理解 Windsurf 如何進入真實專案、如何和 Codex / Claude Code / Cursor 分工。
怎麼選擇閱讀路徑
| 你的狀態 | 先讀什麼 | 目標 |
|---|---|---|
| 還沒安裝 | 官方教程中文版 | 跑通安裝、登入、匯入配置和第一輪 Cascade 對話 |
| 能開啟 Cascade，但不會穩定使用 | 第一次專案閉環 | 用只讀、單檔案編輯、驗證三步建立安全節奏 |
| 想讓它記住專案規則 | 上下文、規則與 AGENTS.md | 區分 Memories、Rules、AGENTS.md 和 .codeiumignore |
| 想接外部工具 | MCP、Skills 與 Workflows | 判斷什麼放 MCP，什麼寫成 workflow，什麼沉澱為 skill |
| 準備團隊使用 | 終端與命令安全 | 設定 auto-execution、allow/deny list、管理員上限和金鑰邊界 |
不要只把 Windsurf 當 Cursor 替代品。它真正值得拆的是 Cascade 如何拿到上下文、如何執行命令、如何沉澱規則，以及哪些動作必須繼續人工確認。
官方來源
- Windsurf 官方文件：https://docs.windsurf.com/windsurf/getting-started
- Cascade 文件：https://docs.windsurf.com/windsurf/cascade/cascade
- 官方文件索引：https://docs.windsurf.com/llms.txt
- Cognition 收購公告：https://cognition.ai/blog/windsurf
- Windsurf 更新記錄：https://windsurf.com/changelog
使用前的安全提醒
Windsurf 能讀專案、改檔案、執行命令、接 MCP、儲存規則，也能在團隊環境裡被管理員集中控制。進入真實專案時按低風險順序推進：
- 第一輪任務只讀：讓 Cascade 解釋專案結構和關鍵路徑。
- 第一次寫操作限定單檔案，並要求說明修改原因。
- 多檔案任務先讓它產出計劃，再分批執行。
- 命令自動執行先用 allowlist only，不直接開 Turbo。
- MCP 金鑰只走環境變數或檔案插值，不寫進
mcp_config.json。 - 分享對話、提交程式碼、部署、刪除資料前必須人工確認。
延伸學習
- 翔宇工作流主站：xiangyugongzuoliu.com
- 翔宇 AI 程式設計實操課：檢視課程介紹與學習路徑