---
title: "Windsurf 官方教程中文版"
description: "按 Windsurf 官方文档能力域重组的中文查询手册，覆盖安装、Cascade、上下文、MCP、Skills、模型和团队控制。"
verifiedAt: "2026-05-09"
---

这一组不是逐字翻译，而是把 Windsurf 官方文档重组成中文开发者能直接查、直接落地的教程。事实边界来自 Windsurf / Cognition 官方资料和 MCP 官方规范；模型、价格、用量、计划、企业控制这类高波动事实，只写查询入口和决策边界。

> [!NOTE]
> **先给结论**：个人上手按“安装 → Cascade → 上下文 → 终端”读；团队上线按“MCP → Skills/Workflows → 模型用量 → 团队控制”补齐治理。

## 阅读入口

<Cards>
  <Card title="安装与首次启动" description="下载、登录、导入 VS Code/Cursor 配置，确认 PATH 和第一次只读验证。" href="/docs/windsurf/official/00-setup-onboarding" />
  <Card title="Cascade 核心能力" description="理解 Code/Chat、计划、队列、工具调用、checkpoint、revert 和多会话。" href="/docs/windsurf/official/01-cascade-core" />
  <Card title="上下文与规则" description="区分 Memories、Rules、AGENTS.md、Workflows、Skills 和 .codeiumignore。" href="/docs/windsurf/official/02-context-rules-agents" />
  <Card title="终端与命令控制" description="设置 Command、auto-execution、allow/deny list、团队命令策略和 dedicated terminal。" href="/docs/windsurf/official/03-terminal-command-control" />
  <Card title="MCP 集成" description="使用 Marketplace、mcp_config.json、HTTP/SSE、认证插值、tools 限制和企业 registry。" href="/docs/windsurf/official/04-mcp-integration" />
  <Card title="Skills、Workflows 与 Hooks" description="判断什么时候写 Skill、Workflow、Hook，什么时候只用 Rule 或 AGENTS.md。" href="/docs/windsurf/official/05-skills-workflows" />
  <Card title="模型、Adaptive 与用量" description="理解 Adaptive、SWE 模型族、BYOK、quota、extra usage 和团队模型策略。" href="/docs/windsurf/official/06-models-usage" />
  <Card title="团队控制与排障" description="梳理 Admin Portal、SSO/SCIM、RBAC、命令、MCP、共享、日志和常见故障。" href="/docs/windsurf/official/07-teams-troubleshooting" />
</Cards>

## 学习路径

```mermaid
flowchart TD
    Start["第一次上手"] --> Setup["安装与首次启动"]
    Setup --> Cascade["Cascade 核心能力"]
    Cascade --> Context["上下文与规则"]
    Context --> Terminal["终端与命令控制"]
    Terminal --> Use{"个人使用还是团队上线?"}
    Use -->|个人继续进阶| Models["模型、Adaptive 与用量"]
    Use -->|团队上线| MCP["MCP 集成"]
    MCP --> Skills["Skills 与 Workflows"]
    Skills --> Models
    Models --> Team["团队控制与排障"]

    style Cascade fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Terminal fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Team fill:#fee2e2,stroke:#dc2626,stroke-width:2px
```

## 官方事实源

| 主题 | 官方来源 |
| --- | --- |
| 安装与 onboarding | [Welcome to Windsurf](https://docs.windsurf.com/windsurf/getting-started) |
| Cascade | [Cascade Overview](https://docs.windsurf.com/windsurf/cascade/cascade) |
| Memories / Rules / AGENTS.md | [Memories & Rules](https://docs.windsurf.com/windsurf/cascade/memories)、[AGENTS.md](https://docs.windsurf.com/windsurf/cascade/agents-md) |
| Terminal | [Terminal](https://docs.windsurf.com/windsurf/terminal) |
| MCP | [Model Context Protocol (MCP)](https://docs.windsurf.com/windsurf/cascade/mcp)、[MCP Specification](https://modelcontextprotocol.io) |
| Skills / Workflows | [Skills](https://docs.windsurf.com/windsurf/cascade/skills)、[Workflows](https://docs.windsurf.com/windsurf/cascade/workflows) |
| Models / Usage | [AI Models](https://docs.windsurf.com/windsurf/models)、[Adaptive](https://docs.windsurf.com/windsurf/adaptive)、[Quota-Based Usage](https://docs.windsurf.com/windsurf/accounts/quota) |
| Teams / Troubleshooting | [Guide for Admins](https://docs.windsurf.com/windsurf/guide-for-admins)、[Common Windsurf Issues](https://docs.windsurf.com/troubleshooting/windsurf-common-issues) |
| 全量索引 | [Windsurf llms.txt](https://docs.windsurf.com/llms.txt) |

## 查阅顺序

如果你只想把 Windsurf 跑起来：

1. [安装与首次启动](/docs/windsurf/official/00-setup-onboarding)
2. [Cascade 核心能力](/docs/windsurf/official/01-cascade-core)
3. [上下文、规则与 AGENTS.md](/docs/windsurf/official/02-context-rules-agents)
4. [终端与命令控制](/docs/windsurf/official/03-terminal-command-control)

如果你要把 Windsurf 接进团队流程：

1. [MCP 集成](/docs/windsurf/official/04-mcp-integration)
2. [Skills 与 Workflows](/docs/windsurf/official/05-skills-workflows)
3. [模型、Adaptive 与用量](/docs/windsurf/official/06-models-usage)
4. [团队控制与排障](/docs/windsurf/official/07-teams-troubleshooting)

## 术语口径

| 术语 | 本系列中的用法 |
| --- | --- |
| Windsurf | IDE 产品本体 |
| Cascade | Windsurf 内的 agentic AI assistant |
| Rules | 持久行为规则，可全局、workspace、system 级配置 |
| AGENTS.md | 目录范围规则，进入 Cascade 同一套 Rules engine |
| Workflows | 手动 slash command 调用的多步流程 |
| Skills | 带 `SKILL.md`、脚本、模板、资源的能力包 |
| MCP | Model Context Protocol，用于把外部工具和服务接给 Cascade |
| Adaptive | Cognition 的智能模型路由，由 Windsurf 根据任务选择底层模型 |

<details>
<summary>深读：为什么官方教程要和实战教程分层</summary>

官方教程负责事实边界：路径、入口、限制、官方建议、企业控制和排障来源。实战教程负责把这些事实组合成真实项目方法，比如第一次只读验证、命令 deny list、MCP 准入、Skill 目录策略和模型预算控制。

这两层不能混在一起。官方事实会变化，所以每篇都保留核验日期和官方来源；实战经验会沉淀成判断规则，但不能覆盖官方页面里的最新价格、模型和企业功能状态。
</details>

## 本组自检

读完整组后，用这 4 个问题检查：

1. 你能否在新机器上完成安装、登录、PATH 和第一次只读 Cascade 验证？
2. 你能否区分 Memories、Rules、AGENTS.md、Workflows、Skills 和 MCP？
3. 你能否给真实仓库设置终端 allow/deny list 和 `.codeiumignore`？
4. 你能否为团队列出模型、命令、MCP、共享、SSO/SCIM 和排障的上线清单？

通过标准：你能把 Windsurf 作为一个可治理的 AI IDE 使用，而不是只把它当作聊天侧栏。
