如何在 VS Code 安装并使用 Codeium(Windsurf Plugin):扩展、登录、自动补全与聊天
安装 Windsurf Plugin、完成登录,等语言服务器就绪后在仓库里拿到第一条内联建议,或用 @ 在聊天里提问。
第一次在 VS Code 里用 Windsurf Plugin(原 Codeium),卡住的通常不是提示词,而是扩展有没有装对、账号有没有登录成功,以及语言服务器下载完成后自动补全和侧边栏聊天有没有真正连上。
检索词是 如何在 VS Code 安装并使用 Codeium / Windsurf Plugin。下文对照官方文档 docs.devin.ai/windsurf/plugins/getting-started 的 VS Code 章节与 Marketplace 项 Windsurf Plugin (formerly Codeium)。这是 Windsurf 的 VS Code 扩展,不是本站会议产品。要约短会对齐改动,用 sitdraw 建房即可,步骤见 如何创建与加入房间。
先核对 Marketplace 里的正确扩展
Windsurf Plugin(原 Codeium)提供 Autocomplete、Chat 与 Command 三大功能。Marketplace 请搜 Windsurf Plugin (formerly Codeium)——品牌已从 Codeium 迁移到 Windsurf。安装后语言服务器后台下载,通常 10–20 秒。
第一次:安装、登录、补全、聊天
1. 从 VS Code 市场安装
打开 VS Code,
Cmd+Shift+X或Ctrl+Shift+X。搜索 Windsurf Plugin 或 Codeium,选带 formerly Codeium 的项,Install。Quick Open:ext install Codeium.codeium。2. 注册或登录
通知栏弹出登录提示,或点活动栏 Windsurf 图标 / 状态栏头像。用 Google、GitHub 或邮箱登录。语言服务器自动下载约 10–20 秒。
3. 验证自动补全
打开自己的仓库,在代码文件里打字。
Tab接受,Alt+]/Alt+[切换,Alt+\手动触发。4. 打开聊天并 @ 引用
左侧边栏 Chat 面板。
Ctrl+Shift+A(macOSCmd+Shift+A)切换焦点。输入@引用文件或文档。
# First hour · Windsurf Plugin (formerly Codeium) · VS Code · 2026-09
# 1. Extensions → Windsurf Plugin (formerly Codeium)
# 2. Sign in via notification or profile icon
# 3. Wait 10–20s for language server
# 4. Tab accept · Alt+\ trigger · Alt+]/[ cycle
# 5. Ctrl+Shift+A → Chat with @ mentions
# Privacy: .codeiumignore at repo root功能、快捷键与隐私设置
| 功能 | 官方行为 | 第一次注意 |
|---|---|---|
| 自动补全 | Tab 接受;Alt+]/[ 切换;Alt+\ 触发 | 等语言服务器下载完成 |
| 聊天 | 左侧边栏;Ctrl+Shift+A;@ 引用 | 先问只读问题 |
| 命令 | 命令面板 Windsurf/Codeium 命令 | 可搜 explain、refactor |
| 隐私排除 | .codeiumignore / .devinignore 于仓库根 | 排除 .env、secrets/ |
| Telemetry | telemetry.telemetryLevel = all | Chat 需要完整遥测 |
- 品牌已迁移
- Marketplace 现名 Windsurf Plugin (formerly Codeium)。搜旧名仍能找到,请核对发布者。
- 补全与 Copilot 冲突
- 同时启用 GitHub Copilot 会打架。第一次测试建议只留 Windsurf Plugin。
- 教程页不是会议说明书
- 只讲 Windsurf Plugin 第一次。短会见 sitdraw 与 白板对照。
还想核对的问题
装完没有补全?
确认已登录且语言服务器下载完成(10–20 秒)。仍无反应则 Reload Window,检查 .codeiumignore 是否排除了当前文件。
Chat 无法 @ 引用?
需打开文件夹而非单文件。 @ 引用工作区内文件;大文件可能被截断。
.codeiumignore 怎么写?
仓库根目录创建,语法同 .gitignore。列出 .env、secrets/、*.pem 等路径。也支持 .devinignore。