Windsurf 编辑器使用指南

Windsurf 是由 Codeium 团队推出的新一代 AI 编辑器，它不仅仅是 Copilot，更是全新的 IDE 形态。其核心 "Cascade" 引擎能够深度理解整个代码库，实现真正的 Agent 级编程体验。

---

1. Windsurf 简介

Windsurf 是基于 VS Code 开发的 IDE，因此它完美兼容 VS Code 的所有插件和主题。

• 核心理念：Collaborative AI（协作式 AI）。它不仅仅通过对话框交互，更能感知你的光标位置、打开的文件以及终端输出。
• Cascade Flow：Windsurf 的核心工作流，支持深度上下文理解和多文件编辑。

2. 安装与配置

1. 下载: 访问 windsurf.ai 下载安装包 (Windows/Mac/Linux)。
2. 迁移: 首次启动时，它可以自动导入 VS Code 的配置、快捷键和已安装插件。
3. 账号: 登录 Codeium 账号以激活 AI 功能（提供免费额度和付费 Pro 版）。

3. 核心功能详解

3.1 Cascade (全局 AI 助手)

这是 Windsurf 的大脑。通过快捷键 Ctrl+L (Windows) 或 Cmd+L (Mac) 唤起。

• Write Mode (写入模式)：

  • 能够直接修改代码文件。
  • 示例 Prompt："帮我创建一个 React 登录组件，并添加 Tailwind 样式。"
  • Cascade 会分析你的项目结构，生成新文件或修改现有文件，并展示 Diff 供你确认。

• Chat Mode (对话模式)：

  • 仅回答问题，不修改代码。适合解释代码逻辑或规划架构。

• 上下文感知 (Local Indexing)：

  • Windsurf 会自动索引本地代码库。当你提问时，它不仅看当前文件，通过 RAG 技术检索整个项目的相关片段。

3.2 Supercomplete (超级补全)

比传统的 GitHub Copilot 更强大。

• 它不仅补全当前行，还能根据上下文预测你接下来的几步操作（Predictive Coding）。
• 支持 "Fill-in-the-middle" (FIM)，即根据光标前后的代码补全中间逻辑。

3.3 Command Loop (终端交互)

Cascade 可以直接读取终端的错误报错，并给出修复建议。

• 场景：运行 npm run dev 报错时，直接在 Cascade 中点击 "Fix"，它会分析错误日志并修改代码。

4. 使用技巧

4.1 @提及 (Context Pinning)

在对话框输入 @ 可以引用特定资源：

• @File: 引用特定文件。
• @Directory: 引用整个文件夹。
• @Codebase: 强制搜索整个代码库。
• @Docs: 引用外部文档（需配置）。

4.2 常用快捷键

• Cmd + L: 打开/聚焦 Cascade 对话框。
• Cmd + I: 行内 AI 编辑 (Inline Edit)，在光标处直接生成或修改代码。
• Tab: 接受代码补全建议。

4.3 最佳实践

• 小步迭代：虽然 Windsurf 能写很长的代码，但建议分步骤指令，例如先写结构，再写样式，最后写逻辑。
• Review Diff：在 Cascade 修改文件后，务必查看 Diff 视图，确认修改无误后再保存。

---

5. 与 Cursor 的对比

注：两者都在快速迭代中，建议亲自体验选择适合自己的工具。

---

最后更新：2025-12