VSCode上下文菜单_右键功能扩展定制

秋强小哥_5916

秋强小哥_5916

2025-11-19

187人浏览

原创

答案:通过package.json的contributes.menus配置可在VSCode右键菜单添加自定义命令,结合when条件控制显示,命令逻辑在extension.js中实现。

vscode上下文菜单_右键功能扩展定制

在 VSCode 中,右键菜单(上下文菜单)是日常开发中高频使用的功能区域。通过扩展定制,你可以为特定文件类型、编辑区域或资源管理器添加自定义命令,极大提升工作效率。实现这一目标主要依赖于 VSCode 的插件系统和 package.json 中的贡献点配置。

理解上下文菜单结构

VSCode 的右键菜单由多个上下文区域组成,常见的包括:

  • explorer/context:文件资源管理器中的右键菜单
  • editor/context:编辑器内选中文本后的右键菜单
  • editor/title/context:编辑器标签页上的右键菜单
  • scm/resourceGroup/context:源代码管理区域的右键菜单

每个区域都可以通过扩展向其中注入新的菜单项。

通过 package.json 配置菜单项

在你的 VSCode 扩展项目中,package.json 的 contributes.menus 字段用于定义菜单位置和行为。示例如下:

{
  "contributes": {
    "menus": {
      "explorer/context": [
        {
          "command": "myExtension.openInCustomTool",
          "when": "resourceExtname == .log",
          "group": "navigation"
        }
      ],
      "editor/context": [
        {
          "command": "myExtension.translateSelectedText",
          "when": "editorTextFocus && resourceLangId == markdown",
          "group": "1_modification"
        }
      ]
    },
    "commands": [
      {
        "command": "myExtension.openInCustomTool",
        "title": "Open in Custom Tool"
      },
      {
        "command": "myExtension.translateSelectedText",
        "title": "Translate Selected Text"
      }
    ]
  }
}

说明:

从网页中提取schema.org、Open Graph和JSON-LD元数据以用于索引
从网页中提取schema.org、Open Graph和JSON-LD元数据以用于索引

使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。

下载
  • command 必须在 commands 中注册,并在 extension.js 中实现逻辑
  • when 控制菜单项显示条件,支持多种上下文判断表达式
  • group 决定菜单分组顺序,如 navigation、1_modification 等有默认排序规则

支持的 when 条件表达式

利用 when 可以精准控制菜单何时出现。常用条件包括:

  • resourceExtname == .js:文件扩展名为 .js
  • resourceLangId == python:当前语言为 Python
  • editorHasSelection:编辑器中有文本被选中
  • view == myCustomView:在某个自定义视图中

这些表达式可组合使用,例如:
editorHasSelection && resourceLangId == javascript

在代码中实现命令逻辑

在 extension.js 中注册命令并处理动作:

const vscode = require('vscode');

function activate(context) {
  let disposable = vscode.commands.registerCommand('myExtension.openInCustomTool', async (uri) => {
    // uri 是右键点击的文件资源
    if (uri) {
      vscode.window.showInformationMessage(`Opening ${uri.fsPath}`);
      // 调用外部工具或执行其他操作
    }
  });

  context.subscriptions.push(disposable);
}
module.exports = { activate };

注意:传递给命令的参数通常包括 uri(文件路径)、selectedText(选中文本)等上下文信息。

基本上就这些。掌握 contributes.menus 配置和 when 表达式,就能灵活定制右键菜单行为,让扩展更贴合实际使用场景。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2395

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

4002

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1316

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4659

7

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

5176

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1475

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1978

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10703

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1080

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习