词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
5.8a VS Code 扩展
在 VS Code、Cursor 等编辑器中使用 OpenCode。
📝 课程笔记
学完你能做什么
支持的编辑器
如果你使用 Zed、JetBrains、Neovim 等编辑器，请查看 5.8b ACP 协议。
安装方式
自动安装（推荐）
1.
2.
3.
opencode - 扩展自动安装手动安装
1.
Cmd+Shift+X / Ctrl+Shift+X）2.
3.
快捷键
| 功能 | macOS | Windows/Linux |
|---|---|---|
| 打开面板 | Cmd+Esc | Ctrl+Esc |
| 新建会话 | Cmd+Shift+Esc | Ctrl+Shift+Esc |
| 插入文件引用 | Cmd+Option+K | Alt+Ctrl+K |
功能说明
@File#L37-42使用流程
1.
Cmd+Esc 打开 OpenCode 面板2.
3.
Cmd+Option+K 插入文件引用4.
选中行自动感应
| 选中内容 | 生成的引用 | 说明 |
|---|---|---|
| 第 10 行 | @file.ts#L10 | 单行 |
| 第 10-20 行 | @file.ts#L10-20 | 多行范围 |
| 未选中 | @file.ts | 整个文件 |
1.
2.
Cmd+Option+K3.
@src/utils.ts#L15-254.
行号引用让 AI 去读取文件，这样：
:::
外部编辑器配置
/editor 或 /export 命令时，OpenCode 会打开外部编辑器。Linux / macOS
~/.bashrc 或 ~/.zshrc）使其永久生效。Windows CMD
set EDITOR=notepad
rem VS Code（需要 --wait）
set EDITOR=code --waitWindows PowerShell
$env:EDITOR = "notepad"
# VS Code（需要 --wait）
$env:EDITOR = "code --wait"常用编辑器
| 编辑器 | 命令 | 需要 --wait |
|---|---|---|
| VS Code | code | 是 |
| Cursor | cursor | 是 |
| Windsurf | windsurf | 是 |
| Neovim | nvim | 否 |
| Vim | vim | 否 |
| Nano | nano | 否 |
| Sublime Text | subl | 是 |
| Notepad | notepad | 否 |
--wait标志使编辑器进程阻塞直到关闭，这是/editor命令正常工作的必要条件。
故障排查
扩展未自动安装
1.
opencode（不是外部终端）2.
code 命令可用cursor 命令可用windsurf 命令可用codium 命令可用Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows)3.
踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
| 扩展没自动装 | 不在集成终端运行 | 在 VS Code 内置终端运行 opencode |
| 快捷键不生效 | 与其他扩展冲突 | 检查快捷键设置，修改冲突项 |
| 编辑器打不开 | EDITOR 变量没设 | 设置 export EDITOR="code --wait" |
| 编辑器打开后立即关闭 | 缺少 --wait 标志 | 添加 --wait 参数 |
延伸阅读
本课小结
1.
2.
3.
4.
下一课预告
下一课我们将学习 ACP 协议，让你在 Zed、JetBrains、Neovim 等编辑器中使用 OpenCode。
附录：源码参考
点击展开查看源码位置
更新时间：2026-03-10
| 功能 | 文件路径 | 行号 |
|---|---|---|
| 选中行检测逻辑 | sdks/vscode/src/extension.ts | 103-136 |
| 获取当前编辑器 | sdks/vscode/src/extension.ts | 104 |
| 行号格式化（单行/多行） | sdks/vscode/src/extension.ts | 119-133 |
修改于 2026-05-31 05:46:05