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 行为：

text

# .windsurfrules 示例

你是一个 TypeScript 全栈开发专家。

技术栈：
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Express + Prisma
- 测试：Vitest + React Testing Library

代码规范：
- 使用函数式组件和 Hooks
- 所有函数必须有 TypeScript 类型标注
- 错误处理使用 try-catch，禁止静默吞错
- 组件文件使用 PascalCase 命名

也支持全局规则文件 ~/.windsurf/global_rules.md，对所有项目生效。

快捷键速查表#

功能macOSWindows/Linux打开 CascadeCmd+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 自主性的接受程度。

使用场景和最佳实践#

适合场景：从零搭建脚手架、批量重构、快速原型、探索不熟悉的技术栈

最佳实践：

1. 先写好 .windsurfrules，确保 AI 输出符合团队规范
2. 大任务用 Cascade，小修改用 Cmd+I 内联编辑
3. Cascade 执行过程中可随时中断并调整方向
4. 定期检查 Cascade 的自动提交，避免引入不需要的改动
5. 敏感文件（.env、密钥）加入 .gitignore，防止 AI 误操作
6. 复杂项目建议分模块给 Cascade 任务，避免一次性改动过大