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，但没测试冲突，结果按了没反应——其实被其他扩展或用户自定义快捷键劫持了。
- 检查冲突最直接的方式：打开命令面板，输入
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 条件与用户当前焦点状态之间的微妙错位——它不报错，只静默失效。 
