首先在 package.json 的 contributes.commands 中声明命令,使其出现在命令面板;接着在 extension.js 中通过 vscode.commands.registerCommand 注册对应功能逻辑;然后通过 contributes.menus 配置上下文菜单,如 explorer/context 或 editor/context,并可使用 when 条件控制显示时机;最后合理利用 category、group 和 arguments 提升用户体验。整个过程以声明式配置为主,结合命令注册实现功能集成。

要在 VSCode 中为自己的扩展插件添加上下文菜单和命令面板入口,主要通过 package.json 的配置和使用 VSCode 扩展 API 来实现。整个过程不需要直接调用底层 API 注册菜单项,而是通过声明式配置结合注册命令完成。
1. 在 package.json 中定义命令
所有命令必须先在 package.json 的 contributes.commands 字段中声明,这是命令出现在命令面板(Command Palette)的前提。
title 是显示名称,category 会在命令面板中作为前缀(如 My Extension: Say Hello),帮助用户分类识别。
2. 注册命令并实现功能
在主文件 extension.js(或 extension.ts)中使用 vscode.commands.registerCommand 注册对应逻辑。
这样,命令“myExtension.sayHello”就被激活,并可在命令面板中执行。
3. 添加上下文菜单入口
通过 contributes.menus 配置,将命令添加到右键菜单。常用的位置包括资源管理器、编辑器、编辑器标签等。
说明:
- explorer/context:在资源管理器中右键文件时显示。
- editor/context:在代码编辑器中右键时显示。
- when:控制菜单项何时可见,例如只对 JS 文件显示。
- group:控制菜单中的分组顺序,如 navigation、clipboard 等。
4. 常见场景与建议
为了让用户体验更自然,可以:
- 使用
arguments向命令传递上下文数据,比如选中的文件路径。 - 结合
vscode.Uri和vscode.workspace获取文件内容或路径。 - 在
when条件中使用标准上下文变量,如resourceScheme == file、editorTextFocus等。 - 避免在高频菜单(如 editor/context)中添加过多项,合理分组。
基本上就这些。只要在 package.json 正确声明命令和菜单位置,并在主模块注册回调函数,VSCode 就会自动处理界面集成。不复杂但容易忽略的是 when 条件和 category 的使用,合理设置能让插件更专业易用。










