Windsurf
→ 返回工具
Codeium 出品的 AI 编程 IDE（基于 VS Code），主打 Cascade 对话式编程助手——不只是补全，而是理解整个代码库上下文后，自主执行多步骤任务。
核心概念
Cascade（瀑布流）
Windsurf 的旗舰功能，区别于传统聊天式 AI 助手：
| 特性 | 说明 |
|---|---|
| 深度上下文感知 | 自动读取项目文件、终端输出、错误信息 |
| 自主多步执行 | 可连续读写多个文件、运行命令、修复错误 |
| 实时感知 | 用户对代码的修改会即时反映给 Cascade |
| Flows 模式 | Agent 式自动完成任务，最小化人工干预 |
操作模式
| 模式 | 行为 |
|---|---|
| Write | 直接修改文件 |
| Chat | 仅对话，不写代码 |
| Inline Edit | 选中代码后就地修改（Ctrl+I） |
| Supercomplete | 跨文件自动补全，比 Copilot 补全更多行 |
常用快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+L | 打开 Cascade 对话窗口 |
Ctrl+I | 内联编辑选中代码 |
Tab | 接受 Supercomplete 建议 |
Alt+] / Alt+[ | 切换多个补全候选 |
Ctrl+Shift+L | 将选中代码发送到 Cascade |
与 Cursor 对比
| 维度 | Windsurf | Cursor |
|---|---|---|
| 底层 | VS Code fork | VS Code fork |
| 核心差异 | Cascade 自主执行 | Composer 对话式 |
| 上下文获取 | 自动感知 | 手动 @file @codebase |
| 免费额度 | 更慷慨（Pro 功能有限免） | 500 次/月 |
| 模型选择 | 多模型（Claude、GPT-4o、自研） | 多模型 |
| 价格 | $15/月（Pro） | $20/月（Pro） |
| 本地模型 | 不支持 | 不支持 |
工作流示例
用户：帮我给这个 Express 应用加上 JWT 认证
Cascade：
1. 读取 src/app.js → 理解当前路由结构
2. 读取 package.json → 确认已有依赖
3. 运行 npm install jsonwebtoken bcryptjs
4. 创建 src/middleware/auth.js
5. 修改 src/routes/user.js → 加入登录/注册路由
6. 修改 src/app.js → 挂载认证中间件
7. 更新 README.md → 补充使用说明
Windsurf Rules
类似 Cursor Rules，在 .windsurf/rules.md 定义项目级别的编码约定，Cascade 会自动遵循：
# 项目规范
- 使用 TypeScript strict 模式
- 组件使用函数式，禁止 class 组件
- 所有 API 调用用 React Query 封装
- 错误信息统一用中文
- 测试文件放在 __tests__ 目录适用场景
- 需要 AI 自主完成跨文件重构
- 大型项目中快速定位并修改多处相关代码
- 结合终端输出循环调试（Cascade 能读取错误自动修复）
- 已有 VS Code 工作流，不想换工具