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、管理员上限和密钥边界