主题
01-02 · Windsurf IDE
Windsurf 是 Codeium 团队（现已并入 Cognition）打造的 AI 原生 IDE。和 VS Code + 插件最大的区别在于：它从底层就围绕"AI Agent + 上下文"设计，能跨文件、跨仓库地理解代码并执行任务。我们公司把它作为 主力 IDE。
一、为什么是 Windsurf
| 维度 | VS Code + Copilot | Cursor | Windsurf |
|---|---|---|---|
| AI 上下文理解 | 单文件为主 | 多文件 | 跨仓库 + Agent 任务级 |
| Agent 模式 | 无 | Composer | Cascade（深度 Agent） |
| 工具调用 | 弱 | 中 | MCP 原生 + 多工具协同 |
| 中文友好度 | 一般 | 一般 | 官方文档支持中文 |
| 公司账号 | 自费 | 自费 | 公司提供共享账号 |
二、安装 Windsurf
2.1 下载
官方下载：https://windsurf.com/editor/download
支持 Windows / macOS / Linux。
2.2 第一次启动
- 启动 Windsurf
- 选择 导入 VS Code 配置（如果你之前用 VS Code），或直接跳过
- 进入登录页 —— 暂时不要登录公司账号，先按下面的步骤装"星火"插件
2.3 把 IDE 切成中文（可选）
Cmd/Ctrl + Shift + P → 输入 Configure Display Language → 选 中文 (简体) → 重启。
三、星火插件 —— 公司账号体系
我们使用 xinghuo-windsurf 作为账号管理 / 模型调度的辅助层。它解决两件事：
- 多账号自动轮换：避免单账号配额耗尽
- 积分压缩：在保证效果的前提下降低 Token 成本
3.1 下载插件
官方分发地址（GitCode 镜像，国内可直连）：
下载里面带有 .vsix 后缀的文件（Windsurf 插件包）以及对应平台的桌面端（Windows / macOS）。
3.2 安装 .vsix 插件到 Windsurf
方法一（GUI）：
- Windsurf 左侧 扩展（Extensions） 图标
- 顶部
…菜单 → Install from VSIX... - 选择刚下载的
.vsix文件 → 重启 Windsurf
方法二（命令行）：
bash
# Windsurf 自带的 CLI（首次使用需在 IDE 里 Cmd+Shift+P → Shell Command: Install 'windsurf'）
windsurf --install-extension /path/to/xinghuo-windsurf.vsix3.3 配置公司账号
- 启动 Windsurf 桌面端 xinghuo 工具（不是 IDE 插件）
- 在工具里登录公司分发给你的账号 / Key
- 工具会托管 Token 池
- 回到 Windsurf IDE，xinghuo 插件会自动识别本机的工具进程并接管登录
公司账号从哪里拿？ 入职时 IT 同事会通过内部 IM 私发给你。禁止外传 / 禁止上传到公开仓库。
3.4 验证
打开 Windsurf，按 Cmd/Ctrl + L 打开 Cascade（Agent 对话），随便问一句 "你是谁，能用什么模型"。如果能正常应答，说明账号链路通了。
四、Windsurf 核心使用心法（公司方法论）
4.1 三种主要交互模式
| 模式 | 快捷键 | 适用场景 |
|---|---|---|
| Cascade（Agent） | Cmd/Ctrl + L | 跨文件改造、Bug 排查、新功能开发 |
| Tab 补全 | 边写边自动 | 单行 / 单函数补全 |
| Inline Edit | Cmd/Ctrl + I | 选中一段代码，让它就地改写 |
4.2 我们要求的工作姿势
- 永远先开 Cascade，再写代码：把需求当成给 Agent 的 brief，让它先搜索、先定位、再动手。
- 善用
@文件 / @符号提示：精确告诉它"读哪里"，比"自己猜"快 5 倍。 - 大任务先让它写计划：让 Cascade 输出一份 plan，确认后再执行。
- 保留对话：复杂的功能开发对话不要清掉，下次继续问"接着上次的，你帮我把 X 也做了"。
4.3 必装的辅助插件
进入 Windsurf 扩展市场，搜索并安装：
| 插件 | 用途 |
|---|---|
| Chinese (Simplified) | 中文界面 |
| GitLens | Git 历史可视化 |
| Error Lens | 错误就地高亮 |
| Markdown All in One | 写文档 / SKILL.md / 课程 |
| Path Intellisense | 路径补全 |
| Prettier / ESLint | 代码风格（按项目按需） |
五、把项目托给 Windsurf 的标准流程
我们公司新建项目都按这个流程走：
1. mkdir my-project && 在 Windsurf 中打开
2. 创建 README.md、AGENTS.md、CLAUDE.md（见 02-核心方法论 模块）
3. 写一个简短的项目目标 brief 到 AGENTS.md
4. 用 Cascade：「请基于 AGENTS.md 帮我搭基础脚手架」
5. 让它生成项目，然后人工 review
6. 后续所有需求都通过 Cascade 提，不直接手写文件六、参考资料
继续 → 03 · Claude Code CLI