Windsurf AI IDE 技能指南
概述
Windsurf 是 Codeium 推出的 AI 原生 IDE，基于 VS Code fork 构建。核心卖点是 Cascade —— 一个能自主执行多步骤任务的 AI Agent，比传统的代码补全和聊天助手更进一步。
核心功能
Cascade（AI Agent 模式）
Cascade 是 Windsurf 的旗舰功能，区别于普通 AI 聊天：
- 多步骤自动执行：给出高层目标，Cascade 自动拆解为多个步骤依次执行
- 文件读写：自动读取相关文件、创建新文件、修改现有代码
- 终端命令：自动运行 npm install、git commit 等命令
- 上下文感知：自动索引整个项目，理解文件间的依赖关系
- Write/Chat 模式：Write 模式直接修改代码，Chat 模式仅讨论不动代码
使用技巧：
- 描述目标而非步骤，让 Cascade 自己规划执行路径
- 遇到错误时 Cascade 会自动尝试修复，通常不需要手动干预
- 用
@file或@folder显式指定上下文范围，提高准确度
AI Flow（智能代码补全）
AI Flow 是 Windsurf 的上下文感知补全引擎：
- 多行补全：不只补全当前行，能预测接下来多行代码
- 跨文件感知：根据项目中其他文件的模式和类型定义生成补全
- Tab 接受：按 Tab 接受建议，按 Esc 拒绝
- Supercomplete：基于最近编辑行为预测下一步操作
Cmd+I 内联编辑
选中代码后按 Cmd+I（macOS）或 Ctrl+I（Windows/Linux）：
- 直接在代码位置弹出编辑指令输入框
- 适合小范围重构、添加注释、修改逻辑
- 修改以 diff 形式展示，可逐个接受或拒绝
Chat 面板
侧边栏对话面板，用于：
- 询问代码相关问题、解释复杂逻辑
- 生成代码片段后手动粘贴
- 用
@引用文件、符号、文档等上下文
规则配置
在项目根目录创建 .windsurfrules 文件，控制 AI 行为：
# .windsurfrules 示例
你是一个 TypeScript 全栈开发专家。
技术栈：
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Express + Prisma
- 测试：Vitest + React Testing Library
代码规范：
- 使用函数式组件和 Hooks
- 所有函数必须有 TypeScript 类型标注
- 错误处理使用 try-catch，禁止静默吞错
- 组件文件使用 PascalCase 命名
也支持全局规则文件 ~/.windsurf/global_rules.md，对所有项目生效。
快捷键速查表
| 功能 | macOS | Windows/Linux |
|---|---|---|
| 打开 Cascade | Cmd+L | Ctrl+L |
| 内联编辑 | Cmd+I | Ctrl+I |
| 接受补全 | Tab | Tab |
| 拒绝补全 | Esc | Esc |
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P |
| 切换 Write/Chat | 面板内切换 | 面板内切换 |
| 引用文件 | @file | @file |
| 引用文件夹 | @folder | @folder |
| 终止执行 | Cmd+Backspace | Ctrl+Backspace |
Windsurf vs Cursor 对比
| 维度 | Windsurf (Cascade) | Cursor (Composer) |
|---|---|---|
| 自主性 | 高，自动规划多步骤 | 中，需要更多人工确认 |
| 可控性 | 较低，Agent 自行决策 | 高，每步可审查 |
| 代码索引 | 自动全项目索引 | 需手动 @codebase |
| 终端集成 | 自动执行命令 | 需确认后执行 |
| 免费额度 | 有免费层 | 有免费层 |
| VS Code 兼容 | 完全兼容插件 | 完全兼容插件 |
| 适合人群 | 喜欢放手让 AI 干 | 喜欢精细控制 |
Windsurf 更像"放手让 AI 干"，Cursor 更像"AI 辅助你干"。选择取决于你对 AI 自主性的接受程度。
使用场景和最佳实践
适合场景：从零搭建脚手架、批量重构、快速原型、探索不熟悉的技术栈
最佳实践：
- 先写好
.windsurfrules，确保 AI 输出符合团队规范 - 大任务用 Cascade，小修改用 Cmd+I 内联编辑
- Cascade 执行过程中可随时中断并调整方向
- 定期检查 Cascade 的自动提交，避免引入不需要的改动
- 敏感文件（.env、密钥）加入
.gitignore，防止 AI 误操作 - 复杂项目建议分模块给 Cascade 任务，避免一次性改动过大