如何通过优化设置在VSCode中自定义右键菜单项？

本文共计1285个文字，预计阅读时间需要6分钟。

VSCode 的快捷菜单无法仅通过设置界面拖拽增删，所有自定义都需要通过 `settings.json` 或注册表——前者为传统编辑器/资源管理器内右键，后者为系统级文件/文件夹右键。

编辑器区域右键菜单：用 editor.contextmenu 数组控制

这个配置只影响你在代码编辑区（不是侧边栏、不是空白处）右键弹出的菜单。它不是开关式布尔值，而是一个数组，每个元素定义一个菜单项是否显示、排在哪、什么条件下出现。

• 必须写成 "editor.contextmenu": [] 形式，空数组表示清空所有默认项（慎用）；想保留部分就手动列出要留下的命令 ID
• 命令 ID 要准确，比如格式化是 "editor.action.formatDocument"，不是 "format" 或 "formatDocument"；查法：打开命令面板（Ctrl+Shift+P），输功能名，看右侧显示的完整 ID
• when 条件很关键，例如 "when": "editorTextFocus && editorLangId == 'javascript'" 表示只在 JS 文件有焦点时显示；漏写 editorTextFocus 可能导致菜单不弹
• 排序靠 group 字段，如 "group": "1_modification" 比 "9_cutcopypaste" 靠前；数字越小越靠上，但别乱填非标准值，否则可能被忽略

插件注入的右键项：优先查 menuVisibility 配置

很多插件（GitLens、ESLint、Prettier）从 1.84 版本起支持通过 menuVisibility 控制自身菜单项显隐。这比禁用整个插件更精准，也避免功能丢失。

• 配置项必须是字符串 "hidden"，写成 false、null 或 0 都无效
• ID 名称得去插件文档里找，比如 GitLens 的 “Compare with Branch” 对应 "gitlens.compareWithBranch"；搜不到就打开开发者工具（Help → Toggle Developer Tools），右键触发一次，看 Console 里报错的 command 名
• 不是所有插件都支持该机制，老版本或小众插件仍需禁用插件本身来移除菜单项
• 改完 settings.json 后必须完全重启 VSCode（不只是重载窗口），否则残留缓存可能导致菜单未更新

Windows 系统级右键菜单：改注册表，不是 VSCode 设置

“在 VS Code 中打开文件”“在 VS Code 中打开文件夹”这类选项，根本不在 VSCode 进程里运行，而是 Windows 资源管理器读取注册表后渲染的。VSCode 自身设置对它完全无效。

• 核心路径分三类：HKEY_CLASSES_ROOT*shell（所有文件）、HKEY_CLASSES_ROOTDirectoryshell（文件夹）、HKEY_CLASSES_ROOTDirectoryBackgroundshell（空白处）
• 不要直接删注册表项，容易误伤；推荐新建字符串值 LegacyDisable（值为空）来禁用某条目，安全可逆
• 添加新项时，command 子项的默认值必须带引号包裹路径和参数，例如：""C:\Users\Me\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V""；路径错一个斜杠或少一个引号，右键就静默失败
• 修改后必须重启 Windows 资源管理器进程（任务管理器 → 重启“Windows 资源管理器”），或者注销重登，改完立刻生效是假象

卸载插件后右键还有空项？不是缓存，是注册表残留

插件卸载后右键出现灰色无响应项，或点击报 command 'xxx' not found，说明 VSCode 已清理自身逻辑，但注册表里还挂着旧的 shell 命令入口——这是 Windows 层面的问题，不是 VSCode bug。

• 先确认插件是否真从 ~/.vscode/extensions/ 目录下物理删除；没删干净的话，手动进该目录把对应文件夹彻底移走
• 打开注册表编辑器，搜索插件名或报错里的 command ID（比如 path-intellisense.copyPath），定位到 *shell 或 Directoryshell 下的对应子项，加 LegacyDisable
• 别信“一键清理工具”，它们常暴力删键，可能干掉系统必需项（比如“在此处打开 PowerShell”）
• 改注册表前务必导出备份（文件 → 导出），恢复只需双击 .reg 文件

最易被忽略的一点：VSCode 编辑器右键和 Windows 文件右键是两套独立系统，改错地方等于白忙；而插件菜单的隐藏能力取决于它是否适配 menuVisibility，不是所有插件都跟进了这个机制。