Windsurf 中文教學

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
Windsurf	風帆 IDE	Codeium 的 agent 優先 AI 編輯器。
兩條線	two tracks	理解篇打底，官方篇查細節。
按需進入	entry	按目標選先讀哪條線。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按目標決定先讀 Windsurf 的理解篇還是官方篇。

你是 Windsurf 教學導航顧問。

【角色】
Windsurf 教學導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。

【輸入】
- 我的目標：___
- 對 Windsurf 的瞭解：___
- 最想解決的問題：___
- 可投入時間：___
- 經驗水平：___

【工作流程】
1. 按目標區分兩條線用途
2. 給先讀哪條的建議
3. 排推薦順序
4. 標出可跳讀的
5. 給第一步

【輸出規範】
▌一、兩條線用途
▌二、先讀哪條
▌三、推薦順序
▌四、按需跳讀 + 第一步

【硬約束】
- 按目標選線不強行通讀
- 先理解後查手冊
- 貼合經驗水平
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

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

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