根本原因是vscode只识别package.json中contributes.commands声明的命令id，注册时id必须与registercommand第一个参数逐字符一致，且需reload窗口生效。
命令注册后 Command Palette 里搜不到
根本原因不是代码没运行，而是 VSCode 根本没“看见”这个命令——它只认 package.json 里 contributes.commands 声明过的 ID。哪怕 registerCommand 调用成功，ID 对不上就等于白注册。
检查要点：
-
package.json的contributes.commands数组必须存在，且每个对象的command字段值（如"my-ext.toggle-feature"）要和vscode.commands.registerCommand('my-ext.toggle-feature', ...)第一个参数**逐字符一致**：大小写、连字符、点号都不能错 -
activationEvents必须包含对应触发条件，比如用了onCommand:my-ext.toggle-feature，就得先手动执行一次该命令才能激活插件；想一开编辑器就可用，得加"*"或"onStartup"（需 VS Code ≥1.86） - 改完
package.json后必须执行Developer: Reload Window，热更新不重新扫描 contribution
F5 启动调试但断点不命中、console.log 不输出
这不是插件代码问题，而是你没在正确的上下文里触发它。VSCode 插件调试必须走 Extension Development Host 窗口，且 activate 函数只有在满足 activationEvents 时才执行。
实操建议：
- 按
F5启动后，注意弹出的是“Extension Development Host”窗口（标题栏带 [Extension Development Host]），不是主编辑器窗口 - 在该窗口中按
Ctrl+Shift+P输入你的命令名并执行，才能触发activate和后续断点 -
console.log默认输出到「Debug Console」面板，不是浏览器开发者工具的 Console；更可靠的方式是用vscode.window.showInformationMessage()直接弹窗验证 - 确保
tsconfig.json中sourceMap为true，且编译后的.js.map文件与.js同目录
命令执行时报 “command 'xxx' not found”
这个错误发生在用户从 Command Palette 选中命令之后，说明注册流程在中间断了——不是没注册，是注册失败或被静默吞掉。
排查路径：
- 在
activate函数第一行加console.log('my-ext activated')，看 Output 面板 →Log (Extension Host)是否有输出；没有则说明插件根本没激活 - 检查
registerCommand是否被包在try/catch里，且错误没抛出来；它本身不 throw，但回调里出错会导致静默失败 - 确认回调函数没依赖
this上下文：不要写registerCommand('x', this.handler)，改用箭头函数() => this.handler()或this.handler.bind(this) - 如果命令名含斜杠（如
myext/do-something），package.json里也必须用完全相同的字符串，VSCode 是严格字符串匹配
右键菜单/快捷键绑定了但没反应
命令注册只是第一步，出现在 UI 上需要额外声明。VSCode 不会自动把已注册命令塞进菜单或快捷键列表。
关键配置：
- 右键菜单需在
package.json的contributes.menus下指定位置，例如"editor/context"表示编辑器右键，command值必须和注册名一致 - 快捷键写在
contributes.keybindings，注意when条件（如editorTextFocus）是否满足当前焦点状态；冲突时 VSCode 静默忽略，不会报错 - 改完
menus或keybindings后同样要Developer: Reload Window
package.json 声明和 reload 窗口这一步——写完代码不 reload，等于没改。
