VSCode中命令不显示在Command Palette的首要原因是未在package.json的contributes.commands中声明，且command字段值须与registerCommand()第一个参数完全一致；其次需确保activationEvents包含onCommand:xxx，修改后必须重载窗口。
命令注册后不显示在 Command Palette 里
VSCode 不会自动把所有注册的命令都塞进 Command Palette，必须显式声明 contributes.commands 才能被发现。
- 检查
package.json中是否在contributes下写了commands数组，且command字段值与vscode.commands.registerCommand()的第一个参数完全一致（包括大小写和点号） - 确保
package.json的activationEvents包含了对应命令的onCommand:xxx，否则插件可能根本没激活就去调命令 - 改完
package.json后必须重载窗口（Developer: Reload Window），热更新不触发 contribution 重新扫描
registerCommand 回调里 this 指向丢失
直接传箭头函数或普通函数到 vscode.commands.registerCommand() 时，this 默认是 undefined，不是插件激活时的上下文对象。
- 不要写
registerCommand('my.cmd', this.handler)——this.handler被取出来后就脱离了原始对象 - 改用
registerCommand('my.cmd', (...args) => this.handler(...args))或registerCommand('my.cmd', this.handler.bind(this)) - 更稳妥的做法是把依赖项（比如
context、配置、状态管理器）提前存为闭包变量，而非依赖this
命令执行时报错 “command 'xxx' not found”
这个错误不是运行时报的，而是用户在 Command Palette 里选中后、VSCode 尝试调用时抛出的，说明注册流程断在了中间环节。
- 确认
activate()函数确实被执行了：在函数开头加console.log('activated')，看 Output 面板 >Log (Extension Host)有没有输出 - 检查
registerCommand是否被包裹在try/catch里且吞掉了错误；它本身不抛异常，但内部逻辑出错会导致静默失败 - 如果命令名含斜杠（如
myext/do-something），确保package.json里也用了完全相同的字符串，VSCode 对命令名是严格字符串匹配
想让命令支持右键菜单或快捷键但没反应
命令注册只是第一步，要出现在上下文菜单或响应快捷键，还得额外配置 menus 和 keybindings。
- 右键菜单需要在
package.json的contributes.menus下指定位置，例如editor/context表示编辑器右键，command值必须和注册名一致 - 快捷键绑定写在
contributes.keybindings，注意when条件表达式（如editorTextFocus）是否满足当前焦点状态 - 修改
menus或keybindings后同样要重载窗口，且快捷键冲突时 VSCode 会静默忽略新绑定，可打开Preferences: Open Keyboard Shortcuts (JSON)检查是否有覆盖
最常卡住的地方其实是 package.json 和代码里命令名不一致，以及改了配置忘了重载窗口。这两个点不解决，后面怎么写逻辑都没法触发。
