Windsurf — AI 原生代码编辑器¶

# === 官网下载安装 ===
# 1. 打开 https://windsurf.com/editor
# 2. 点击 "Download Windsurf" 选择你的系统
# 3. 安装后打开

# === Linux 安装（Debian/Ubuntu） ===
# 从官网下载 .deb 包后：
sudo dpkg -i windsurf_*.deb  # 安装 Windsurf 的 deb 包
sudo apt-get -f install  # 修复可能缺失的依赖

首次启动后：
1. 登录/注册 — 用 Google 或 GitHub 账号
2. 导入 VS Code 设置 — Windsurf 支持一键迁移
3. 选择主题和字体 — 和 VS Code 操作一样
4. 开始使用 Cascade — 点击侧边栏的 AI 图标

Cascade 不是普通的代码补全，它是一个"会自己动手的 AI"。

使用方法：
1. 点击侧边栏的 Cascade 图标（或快捷键打开）
2. 用自然语言描述你想做什么
3. Cascade 会自动：
   - 分析你的代码库结构
   - 规划多步骤修改方案
   - 创建和编辑文件
   - 执行终端命令
   - 读取错误日志并修复

举例：
输入："给这个 Flask 应用加一个用户注册接口，包含邮箱验证"
Cascade 会自动创建路由、模型、验证逻辑、测试代码

# Tab 补全 — 写代码时 AI 预测你要写什么
def calculate_total(items):  # 写到这里时，AI 会预测下面的代码
    # 按 Tab 接受预测，按 Esc 拒绝

# Tab to Jump — AI 预测你下一步要编辑哪里
# 当你改完一个地方后，按 Tab 会自动跳转到下一个需要修改的位置
# 比如你改了一个函数名，Tab to Jump 会跳到所有调用这个函数的地方

Windsurf 会记住你的习惯和偏好：
- 你常用的框架和工具
- 你的项目结构模式
- 你的代码风格偏好
- 用得越多，AI 越懂你

白话比喻：就像一个同事，合作久了，不用你说他就知道你的习惯

# 在项目根目录创建 .windsurfrules 文件

# 示例内容：
- 使用 TypeScript strict 模式
- 所有 API 返回统一格式 { code, data, message }
- 组件使用函数式组件，不用 class 组件
- CSS 用 Tailwind，不写原生 CSS
- 注释用中文

Windsurf 支持 MCP（模型上下文协议），可以连接：
- Figma — 把设计稿变成代码
- PostgreSQL — 直接查询数据库
- Playwright — 自动化测试
- Slack — 从 Slack 消息生成代码
- Stripe — 集成支付功能

配置方法：
Settings → MCP Servers → 添加你需要的服务

Arena Mode 是 Windsurf Wave 14 引入的独特功能：
1. 同一个提示，两个 AI 模型同时处理
2. 模型身份被隐藏
3. 你选择你觉得更好的结果
4. 系统有个人排行榜和全局排行榜
5. 帮你发现哪个模型最适合你的任务类型

白话比喻：就像选秀节目的盲选，不看脸只听歌，选最好的

如果你有自己的 API Key，可以直接使用：
Settings → Model Provider → Add API Key

支持的模型：
- Anthropic Claude 4 Sonnet / Opus（含思考模式）
- OpenAI GPT-5.1
- 其他 OpenAI 兼容 API