VSCode上下文菜单定制开发-VSCode-PHP中文网

VSCode上下文菜单定制开发

紅蓮之龍

发布： 2025-10-17 14:41:02

原创

874人浏览过

VSCode扩展可通过package.json的contributes.menus配置在资源管理器、编辑器等区域添加自定义右键菜单，结合extension.ts中registerCommand实现命令逻辑，并利用when条件控制显示时机，实现上下文菜单定制。

vscode上下文菜单定制开发

VSCode 的上下文菜单（即右键菜单）可以通过扩展开发进行定制，满足特定工作流的需求。你可以在资源管理器、编辑器、终端等多个区域添加自定义命令。实现方式主要依赖于 package.json 中的贡献点（contribution points）和激活事件，配合注册命令与菜单项。

1. 配置 package.json 菜单项

在你的 VSCode 扩展中，package.json 文件中的 contributes.menus 字段用于定义上下文菜单的显示位置和触发命令。

常见菜单位置包括：

explorer/context：文件资源管理器中的右键菜单
editor/context：代码编辑器内的右键菜单
editor/title/context：编辑器标签页上的右键菜单
scm/resourceGroup/context：源码管理面板中的菜单

示例配置：

"contributes": {
  "menus": {
    "explorer/context": [
      {
        "command": "myExtension.renameFile",
        "group": "modification"
      }
    ],
    "editor/context": [
      {
        "command": "myExtension.formatSelection",
        "when": "editorTextFocus && !editorReadonly"
      }
    ]
  },
  "commands": [
    {
      "command": "myExtension.renameFile",
      "title": "重命名文件（带确认）"
    },
    {
      "command": "myExtension.formatSelection",
      "title": "格式化选中内容"
    }
  ]
}

登录后复制

group 可控制菜单分组排序，如 navigation、clipboard、modification 等；when 表达式可控制菜单项的显示条件。

2. 在 extension.ts 中注册命令

菜单命令需要在主扩展文件（通常是 extension.ts）中通过 registerCommand 实际实现。

示例代码：

import * as vscode from 'vscode';
<p>export function activate(context: vscode.ExtensionContext) {
const renameFile = vscode.commands.registerCommand('myExtension.renameFile', async (resourceUri) => {
if (resourceUri instanceof vscode.Uri) {
const newPath = await vscode.window.showInputBox({ prompt: '输入新文件名' });
if (newPath) {
const newUri = vscode.Uri.joinPath(resourceUri.parent, newPath);
await vscode.workspace.fs.rename(resourceUri, newUri);
}
}
});</p><p>const formatSelection = vscode.commands.registerCommand('myExtension.formatSelection', async (e) => {
const editor = vscode.window.activeTextEditor;
if (editor && !editor.document.isReadOnly) {
const selection = editor.selection;
const text = editor.document.getText(selection);
// 简单处理：转为大写（实际可用 formatter）
await editor.edit(editBuilder => {
editBuilder.replace(selection, text.toUpperCase());
});
}
});</p><p>context.subscriptions.push(renameFile, formatSelection);
}</p>

登录后复制

注意：传递给命令的参数（如 resourceUri）由上下文自动注入，具体类型取决于菜单所在位置。

QCMS 轻量级企业建站系统6.0.5

QCMS企业建站系统是通过MVC架构开发的一套PHP轻量级系统，开源，小巧，易用，功能强大、可以自定义模块，容易二次开发，可以称得上是万能CMS系统，可用于企业站，文章站，图片站，下载站，你只要能想得到，就能做的到。 QCMS V6.0.0 主要功能描述特色说明：简单易用的模板标签，是我们系统的核心组成部分，系统对SEO更友好，源代码全部开放，毫无保留！ 1 内容模块有，新