Windsurf 配置指南

按照以下步骤在你的 Windows 系统上安装 Windsurf。

1你要装的是哪一个？先搞清楚

Windsurf 是一个桌面 IDE，和 Cursor 一样基于 VS Code 深度定制。它的核心卖点是 Cascade AI 代理——能持续执行多步任务的 AI，不只补全代码，更能像 Claude Code 一样自动修改多个文件。如果你想要 IDE 的图形界面 + 接近 CLI 工具的自动化能力，Windsurf 在两者之间取得了较好的平衡。

💡 选型建议：Windsurf 和 Cursor 非常相似，都是 VS Code 的 AI 改造版。Windsurf 的 Cascade 在多步持续性任务上更有优势（"帮我把这个功能从设计到实现"），Cursor 的代码补全更灵敏精准。不确定选哪个的话，两个都有免费版，可以都下载试用后再决定。

2系统要求与前置准备

3下载与安装

Windows 安装

1. 访问 codeium.com/windsurf （国内可直连）
2. 点击 Download for Windows，下载 .exe 安装包

4首次启动与 VS Code 导入

1. 打开 Windsurf：开始菜单搜索 Windsurf，或双击桌面图标
2. 导入 VS Code 设置：首次启动时 Windsurf 会问你是否从 VS Code 导入。选"Import from VS Code"——它会迁移你的主题、快捷键、扩展、设置等
3. 如果你没有装过 VS Code，选 “Skip” 跳过。之后在 Settings → Profiles 中也可以补导入

5注册与订阅

5.1 注册 Codeium 账户

1. Windsurf 界面右下角或右上角点击人头图标
2. 选择使用 Google 或 GitHub 登录（任选其一）
3. 浏览器弹出授权页面 → 确认 → 回到 Windsurf 即登录成功

5.2 选择订阅方案

免费版起步体验。Pro 版 $15/月 比 Cursor Pro ($20/月) 便宜，和 GitHub Copilot 个人版 ($10/月) 价格接近。也可使用自定义 API Key（Settings → Models，支持 OpenAI / Anthropic / Google 等），详见「配置指南」。

6验证安装 — 了解三大核心功能

Windsurf 有三个核心 AI 功能，逐个测试确认安装成功：

① Supercomplete：智能代码补全

打开任意文件，开始写代码——Windsurf 会自动给出灰字补全建议。按 Tab 接受。这是自动触发的，不需要按任何快捷键。

② Cascade：AI 对话面板（Cmd+L / Ctrl+L）

Cascade 是 Windsurf 的核心功能——一个能读写多文件、搜索代码库、执行持续性任务的 AI 代理。

③ Composer：多文件编辑（Cmd+I / Ctrl+I）

Composer 可以一次修改多个文件，保持一致性——特别适合跨文件重构。

7下一步：配置项目规则

安装完成后，建议在项目根目录创建 .windsurfrules 文件，告诉 AI 你的技术栈和编码规范：

# .windsurfrules 示例

## 技术栈
React 18 + TypeScript + Tailwind CSS

## 编码规范
- 使用 const/let，不用 var
- 组件用函数式写法
- 按功能组织文件目录

## Cascade 行为
- 修改代码前先说明计划
- 优先使用项目已有的工具函数

类似 Claude Code 的 CLAUDE.md 和 Cursor 的 .cursorrules。详见「配置指南」标签页。

💡 如果上述步骤遇到问题，建议到 B站或其他网络平台搜索 "Windsurf 安装教程" 或 "Windsurf 使用教程"，视频教程通常有更直观的演示。