命令不显示在Command Palette中是因为package.json未正确声明contributes.commands、activationEvents缺失或command注册名不匹配；VSCode仅识别package.json中显式声明的命令，不扫描registerCommand()调用，且必须重载窗口生效。
命令不显示在 Command Palette 里，基本就是 package.json 没声明、激活事件没配、或注册名对不上——不是代码写错了，是 VSCode 根本没“看见”它。
contributes.commands 声明必须存在且严格匹配
VSCode 不会扫描 registerCommand() 调用，只认 package.json 里 contributes.commands 数组中显式列出的项。漏写、拼错、大小写/点号不一致，都会导致命令“隐身”。
-
command字段值（如"my-extension.format"）必须与vscode.commands.registerCommand("my-extension.format", ...)的第一个参数完全一致 - 描述字段
title是用户在面板里看到的名称，支持空格和中文，但不影响匹配逻辑 - 可选加
category字段（如"My Extension"），会让命令在面板中归类显示，提升可读性
activationEvents 缺失会导致插件未激活就调用失败
即使 contributes.commands 写对了，如果插件根本没激活，VSCode 就不会加载你的 activate() 函数，自然也不会执行 registerCommand()。这时候用户在面板里选中命令，会直接报 "command 'xxx' not found"。
- 必须在
package.json的activationEvents数组中加入对应项，例如"onCommand:my-extension.format" - 多个命令要分别列出来，不能用通配符；
"*"虽然能触发，但会拖慢启动，不推荐 - 改完
package.json后必须执行Developer: Reload Window，热重载不重新扫描 contribution 声明
registerCommand 中的 this 指向问题常被忽略
直接传 this.handler 进去，回调执行时 this 是 undefined，不是你插件激活时的上下文对象。尤其当你 handler 里用了 this.context 或 this.config，立刻报错。
- 别写
vscode.commands.registerCommand("cmd", this.handler) - 改用箭头函数：
vscode.commands.registerCommand("cmd", (args) => this.handler(args)) - 或显式绑定：
vscode.commands.registerCommand("cmd", this.handler.bind(this)) - 更干净的做法：把
context、配置实例等提前解构为闭包变量，彻底避开this依赖
最易踩的坑不在代码逻辑，而在声明与注册之间那层“契约”——VSCode 只信任 package.json 的白名单，不信任运行时的任意注册。哪怕函数已定义、路径无误、控制台没报错，只要声明缺位或激活未触发，命令就永远不会出现在面板里。
