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 编程实操课：查看课程介绍与学习路径