vscode自定义命令不显示在命令面板，是因为必须同时满足两个条件：在package.json的contributes.commands中声明command和title，且title为字符串；仅调用commands.registercommand而不声明则无法显示。

为什么 commands.registerCommand 注册后命令不显示在命令面板？

默认情况下，VSCode 不会自动把自定义命令加入命令面板，除非显式声明 "command" 的 title 属性，并在 package.json 的 contributes.commands 中注册——两者缺一不可。

常见错误是只调用 commands.registerCommand，但没在 package.json 里声明，结果命令能执行（比如通过代码调用），却搜不到、点不出来。

• package.json 中必须包含：

  "contributes": {
    "commands": [{
      "command": "myExtension.doSomething",
      "title": "Do Something Useful",
      "category": "My Extension"
    }]
  }

• title 必须是字符串（不能是变量或 i18n key），否则命令面板不识别
• 如果使用 when 条件（如 editorTextFocus），需确保当前上下文满足，否则命令灰显不可见

如何让快捷键绑定生效且不被内置快捷键覆盖？

VSCode 的快捷键优先级：用户设置 > 工作区设置 > 扩展默认键位 > 内置默认键位。但扩展提供的默认快捷键（keybindings 贡献）仅在安装后首次启动时生效，后续修改需重载窗口或手动触发 Developer: Reload Window。

容易踩的坑是：在 package.json 里写了 keybindings，但没测试冲突，结果按了没反应——其实被其他扩展或用户自定义快捷键劫持了。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 检查冲突最直接的方式：打开命令面板，输入 Preferences: Open Keyboard Shortcuts (JSON)，搜索目标快捷键（如 Ctrl+Shift+P），看是否有重复项
• 推荐用较冷门组合，例如 Ctrl+Alt+K，避免和 Ctrl+P（快速打开）、Ctrl+Shift+P（命令面板）等核心快捷键撞车
• 若需覆盖已有快捷键，必须在 keybindings 贡献中明确写 "when": "always" 或更精确条件，否则 VSCode 可能忽略你的绑定

怎样动态生成命令并实时注入命令面板？

VSCode 不支持运行时动态追加 contributes.commands 列表（那是静态 manifest），但可以通过 commands.registerCommand 注册任意数量命令，只要它们在 activate 时或后续生命周期中调用过——前提是这些命令已在 package.json 中预先声明。

真正“动态”的做法，是提前注册一组泛型命令（如 myExtension.runAction），再通过参数区分行为，而不是为每个动作单独注册新命令名。

• 例如：注册一个通用命令 myExtension.runAction，调用时传入 { id: 'saveAsJson', label: 'Save as JSON' }，内部根据 id 分发逻辑
• 这样只需在 package.json 声明一次，就能支撑 N 种操作，也便于后续添加菜单项或快捷键
• 注意：命令面板只显示 title 字符串，不支持模板插值（如 "Save as ${ext}"），所以动态文本得靠 registerCommand 返回的函数内拼接提示，但不会反映在面板标题上

为什么快捷键在某些编辑器上下文下失效？

VSCode 的 when 条件表达式决定快捷键是否激活，而这个条件不仅影响菜单可见性，也控制快捷键是否响应。最常被忽略的是 editorTextFocus 和 editorHasSelection 这类细粒度条件。

比如你绑定了 Ctrl+Enter 到某个命令，但在终端（Terminal）焦点时按下没反应——不是 bug，是因为终端不满足 editorTextFocus 条件。

• 调试 when 条件：打开命令面板 → 输入 Developer: Toggle Developer Tools → 控制台执行 vscode.env.appName 确认环境，再用 vscode.commands.executeCommand('workbench.action.terminal.toggleTerminal') 测试上下文切换
• 宽松条件可用 focusedView == 'workbench.view.explorer' 或直接省略 when（但慎用，可能全局拦截）
• 若需多上下文支持，应注册多个快捷键条目，或改用 when 组合如 editorTextFocus || terminalFocus

真实项目里，最难调试的往往不是注册逻辑，而是 when 条件与用户当前焦点状态之间的微妙错位——它不报错，只静默失效。