Windsurf

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，对所有项目生效。

快捷键速查表

Windsurf vs Cursor 对比

Windsurf 更像"放手让 AI 干"，Cursor 更像"AI 辅助你干"。选择取决于你对 AI 自主性的接受程度。

使用场景和最佳实践

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

最佳实践：

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