---
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="/docs/windsurf/official" />
  <Card title="从原理到实战" description="8 篇中文讲解，理解 Windsurf 如何进入真实项目、如何和 Codex / Claude Code / Cursor 分工。" href="/docs/windsurf/understanding" />
</Cards>

## 怎么选择阅读路径

| 你的状态 | 先读什么 | 目标 |
| --- | --- | --- |
| 还没安装 | [官方教程中文版](/docs/windsurf/official) | 跑通安装、登录、导入配置和第一轮 Cascade 对话 |
| 能打开 Cascade，但不会稳定使用 | [第一次项目闭环](/docs/windsurf/understanding/02-first-project-loop) | 用只读、单文件编辑、验证三步建立安全节奏 |
| 想让它记住项目规则 | [上下文、规则与 AGENTS.md](/docs/windsurf/understanding/04-context-rules-agents-md) | 区分 Memories、Rules、AGENTS.md 和 `.codeiumignore` |
| 想接外部工具 | [MCP、Skills 与 Workflows](/docs/windsurf/understanding/05-mcp-skills-workflows) | 判断什么放 MCP，什么写成 workflow，什么沉淀为 skill |
| 准备团队使用 | [终端与命令安全](/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)
