VS Code插件开发核心在于activationEvents与contributes的精准匹配：activationEvents决定插件何时加载，contributes声明对外能力；二者不一致会导致命令不可见、菜单缺失或启动变慢，且VS Code不会报错而是静默忽略。
VS Code 插件开发不是“配环境→写代码→打包发布”这种线性流程，而是围绕 activationEvents 和 contributes 两个核心配置做取舍：插件该什么时候启动？它想给 VS Code 贡献什么能力？搞错这两点，轻则命令不响应、菜单不出现，重则拖慢编辑器启动速度。
为什么你的插件命令在命令面板里搜不到？
最常见原因是 package.json 中的 activationEvents 配置和 contributes.commands 不匹配。VS Code 默认懒加载——只有触发了声明的激活事件，插件才会被加载并执行 activate() 函数。
- 如果你写了
"activationEvents": ["onCommand:myExtension.doSomething"]，但没在contributes.commands里注册myExtension.doSomething，那命令永远进不了面板 - 如果误写成
"onCommand:myExtension.dosomething"（大小写不一致），VS Code 完全不认，也不会报错，只会静默忽略 - 用
"*"强制一启动就激活，对小插件方便，但会拖慢 VS Code 启动；生产插件应尽量收窄，比如改用onLanguage:json或onView:myCustomView
src/extension.ts 里 registerCommand 后必须 push 到 context.subscriptions
这是内存泄漏高发区。VS Code 不会自动帮你清理注册的命令、事件监听器或 Webview。一旦漏掉 context.subscriptions.push(disposable)，插件反复启用/禁用几次后，同一个命令可能被注册多次，点击一次弹出多个提示框。
-
vscode.commands.registerCommand、vscode.workspace.onDidChangeConfiguration、vscode.window.onDidChangeActiveTextEditor等返回的都是Disposable对象，必须显式订阅 - TypeScript 下如果没加类型提示，容易把
registerCommand返回值当普通函数处理，结果push失败却不报错 - 不要手动调用
disposable.dispose()—— VS Code 会在插件停用时统一调用所有subscriptions的dispose
package.json 的 contributes 字段决定功能是否“可见”
contributes 是插件对外暴露能力的“说明书”，它不负责逻辑，只负责告诉 VS Code：“我提供了这些菜单、命令、配置项、视图……请按这个规则展示”。漏写或写错字段，功能就等于不存在。
- 加右键菜单要同时写
contributes.menus（指定位置）和contributes.commands（确保命令已声明），否则右键没选项 - 想让命令支持快捷键，除了注册命令，还得在
contributes.keybindings里配command字段，且值必须和commands里的command完全一致 - Webview 面板需要
contributes.views声明容器，再用vscode.window.createWebviewPanel创建实例；只写代码不声明views，侧边栏就不会出现新视图
真正卡住人的从来不是 API 写法，而是 activationEvents 和 contributes 之间那层隐式契约：VS Code 只按 manifest 声明加载资源，不会猜你“本意想干啥”。哪怕 extension.ts 里逻辑完全正确，只要这两处对不上，插件就等于没装。
