Windsurf 入门容易，但要用好需要一些经验和技巧。这一章是我们整理的 10 个实战经验，来自真实项目中的踩坑和总结。
技巧 1：三层上下文管理策略
Windsurf 的上下文管理分三层，不同规模的操作用不同的层：
小改动 → Cmd+K 内联编辑（自动用当前文件 + Rules 作为上下文）
中改动 → Cascade Chat + 手动 @ 引用文件（索引 + Rules + Memory）
大改动 → Agent 模式 + Rules + Memory + MCP（全自动探索代码库）常见错误：什么都用 Agent 模式。改个变量名也开 Agent，白白浪费 credit。小改动用 Cmd+K 最高效。
技巧 2：写好 .windsurfrules 是最高 ROI 的投入
一套好的 Rules 能让 Cascade 的输出质量提升一个量级。这是我们在实际项目中验证过的模板：
# .windsurfrules项目基本信息
- 项目名称：JR Academy 官网
- 技术栈：Next.js 14 + TypeScript + Tailwind CSS + Supabase
- Node 版本：20.x
- 包管理器：pnpm
编码规范
- 使用 TypeScript strict mode，绝不使用 any
- 组件用函数式写法 + React hooks
- 文件命名：组件 PascalCase，工具函数 camelCase，常量 UPPER_SNAKE_CASE
- 所有字符串用单引号，除了 JSX 属性用双引号
架构约定
- API 路由放 app/api/ 目录
- 共享类型定义放 types/ 目录
- 数据库查询统一通过 lib/db.ts 封装
- 环境变量通过 lib/env.ts 类型安全地访问
测试要求
- 新功能必须写单元测试（Vitest）
- 组件测试用 @testing-library/react
- API 路由测试用 supertest
禁止事项
- 不要使用 var，用 const/let
- 不要直接操作 DOM，用 React 的方式
- 不要在组件里直接写 fetch，走 lib/api.ts
- 不要 commit console.log
技巧 3：用 Memory 而不是每次重复解释
如果你发现自己在 Cascade 里反复纠正同样的问题（比如"别用 default export"、"错误处理用 Result 类型"），说明你应该把这些偏好写进 Rules 或让 Memory 自动学习。
主动教 Memory 的方式：
@Cascade 记住：在这个项目里，所有 React 组件用 named export，
不用 default export。错误处理用 neverthrow 库的 Result 类型。这条会被保存到 Workspace Memory，之后 Cascade 生成代码时会自动遵守。
技巧 4：大型重构的正确姿势
不要一次性让 Cascade 重构整个项目。正确的做法是分阶段推进：
第一轮：让 Cascade 分析现状，输出重构计划（Chat 模式）
"分析这个项目的目录结构和代码组织，找出不符合 Next.js 14 最佳实践的地方"第二轮：逐模块执行（Agent 模式）
"按照刚才的计划，先重构 lib/ 目录下的工具函数"
第三轮：验证
"跑一下全部测试，检查有没有 TypeScript 类型错误"
第四轮：下一个模块
"继续重构 components/ 目录"
每轮之间查看 checkpoint，确认没有偏离方向。
技巧 5：Devin 联动——把耗时任务丢到云端
Windsurf 2.0 集成了 Cognition 的 Devin，适合那些你不想在本地等的长时间任务：
- 运行完整的测试套件（30 分钟+）
- 大规模代码迁移
- 依赖升级 + 修复兼容问题
- 生成 API 文档
在 Cascade 里启动 Devin 任务：
@Devin 把这个项目从 React Router v5 迁移到 v6，
修复所有兼容问题，确保所有测试通过Devin 会在云端开一个环境，自主完成整个任务，完成后通知你审查结果。你可以在 Agent Command Center 里同时管理多个 Devin 任务。
技巧 6：善用 Cascade 的预览选择功能
如果你在做前端开发，Windsurf 有一个很实用的功能：在内置预览窗口中，你可以直接点击选中 HTML 元素，然后在 Cascade 里说"把这个按钮改成圆角蓝色"。
Cascade 会自动识别对应的组件代码，精准修改。这比你手动找组件、描述位置要快得多。
技巧 7：模型选择策略
Windsurf 支持多种模型，不同任务选不同模型能平衡质量和 credit 消耗：
简单问题 / 代码解释 → SWE-1.5（最快，950 tok/s，省 credit）
复杂逻辑 / 架构设计 → Claude Sonnet（质量最高）
代码生成 / 重构 → GPT-4o（综合性价比）在 Cascade 面板顶部可以切换当前对话使用的模型。
技巧 8：团队共享 Rules 和 Memory
在团队项目中，.windsurfrules 文件应该提交到 Git：
# .windsurfrules 是项目级别的，所有人共享
git add .windsurfrules
git commit -m "chore: add windsurf rules for team consistency".windsurf/rules/ 目录同理
git add .windsurf/rules/
git commit -m "chore: add windsurf rules directory"这样所有团队成员的 Cascade 都会遵守相同的编码规范——比在 wiki 里写规范文档管用 10 倍，因为 AI 会强制执行而不是建议遵守。
技巧 9：调试时让 Cascade 帮你分析
遇到难调的 bug，试试这个工作流：
1. 在终端跑出错误信息 2. 不用复制——Cascade 已经看到了（实时上下文感知） 3. 直接对 Cascade 说："分析这个错误，给我根因和修复方案" 4. Cascade 会结合错误信息 + 代码上下文 + 项目架构给出分析
比 Google 搜错误信息高效得多，因为 Cascade 知道你的代码的上下文。
技巧 10：定期清理过时 Memory
Memory 系统的一个已知问题是：项目大重构后，旧的 Memory 可能还在影响 Cascade 的行为。
每次大重构后，花两分钟检查一下：
Cascade Settings → Memories → 查看所有已保存的记忆
→ 删除不再适用的条目比如你从 Redux 切到了 Zustand，但 Memory 里还记着"状态管理用 Redux"，就该删掉。
