右键菜单项不出现是因为command未成功注册；必须在activate中调用vscode.commands.registercommand，command id需与package.json完全一致，且需通过context.subscriptions.push()保持引用，同时menus的when条件、key路径和group值须严格符合官方规范。
右键菜单项不出现？先确认 command 是否注册成功
插件的右键菜单依赖命令（command）被正确注册，否则 menus 配置只是空壳。常见现象是：package.json 里写了 menus，但右键死活不显示；或者点击后报错 command 'xxx' not found。
必须在 activate 函数中调用 vscode.commands.registerCommand，且 command ID 与 package.json 中完全一致（包括大小写、命名空间）。漏掉 context.subscriptions.push() 会导致命令注册后立即被释放——尤其在调试时容易忽略。
- 检查方法：打开命令面板（
Ctrl+Shift+P），输入你定义的 command ID（如myext.helloWorld），看能否搜到并执行 - 调试技巧：在
registerCommand回调开头加console.log('hello from context menu')，然后右键触发，再打开开发者工具（Help → Toggle Developer Tools）看 Console 是否输出 - 注意：如果插件启用失败（比如
activate抛异常），整个命令注册流程会中断，右键菜单自然不会加载
菜单显示条件（when）写错，等于没配
when 是右键菜单是否渲染的开关，不是可选配置。写错或遗漏关键条件，菜单项就“隐身”——不是消失，是根本没生成 DOM 节点。
最常踩的坑是：编辑器右键忘了加 editorTextFocus，资源管理器右键漏了 explorerResourceIsFolder 或 explorerResourceIsFile。这些条件必须用逻辑与（&&）拼接，不能用逗号或空格。
- 编辑器内右键必备：
"when": "editorTextFocus"（光标在编辑器中）；若只对 JS 文件生效，补上&& editorLangId == 'javascript' - 资源管理器右键判断路径类型：
"when": "explorerResourceIsFile && resourceExtname == '.log'"表示仅对 .log 文件显示 - 调试时快速验证：
"when": "true"强制显示（仅临时用），确认是条件问题还是其他环节出错
命令面板里能搜到，右键却没反应？查 menus 路径和分组
右键菜单位置由 menus 的 key 决定，不是所有位置都支持任意 command。比如把 editor/context 的配置误写成 editor/title，VS Code 会静默忽略，不报错也不渲染。
另外，group 值影响排序，但填错会导致菜单项被丢弃——VS Code 只认预设 group 名，如 1_modification、navigation、z_commands。写成 mygroup 或 group1，该项大概率不出现。
- 合法 menus key 示例：
"editor/context"（编辑器代码区）、"explorer/context"（资源管理器文件/文件夹）、"terminal/context"（终端区域） - 查 group 规范：打开 VS Code 源码仓库搜索
menuRegistry，或参考官方文档 “Menu Contributions” 章节中的预设值列表 - 一个实用技巧：在
menus中临时加一个已知有效的 command（如editor.action.formatDocument），确认该位置本身是否可渲染
调试插件菜单时，别跳过 reload 和缓存清理
VS Code 插件开发中，“重载窗口”（Developer: Reload Window）通常不够——它只刷新 UI 层，旧的 command 注册可能还驻留在内存里，导致新旧逻辑混杂。尤其是 when 条件变更后，经常出现“改了但没生效”的假象。
真正干净的调试流程是：停掉插件宿主窗口 → 关闭所有 VS Code 实例（任务管理器里确认无 Code.exe 进程）→ 清理插件开发环境缓存（.vscode-test 目录可删）→ 再次运行 F5 启动调试。
- 如果你用的是
vscode-test脚本测试，确保每次运行前npm run compile已更新extension.js，否则改了 TypeScript 却在跑旧 JS - 遇到“菜单有时出现有时不出现”，大概率是多实例残留或扩展 host 缓存未清，不是代码逻辑问题
