activate函数必须注册命令且package.json中activationevents与contributes.commands严格匹配，否则命令不可见、插件不加载；修改后需重载窗口，业务逻辑须封装在registercommand回调内，编译输出js至out/目录方可打包。
activate 函数必须注册命令，否则你在命令面板里搜不到它；package.json 里的 activationEvents 和 contributes.commands 必须严格匹配，否则插件压根不会被加载。
为什么按 F5 启动后命令面板里找不到你的命令？
最常见的原因是 package.json 没声明命令，或声明了但 ID 和 registerCommand 调用时不一致。VS Code 不会自动扫描代码里的字符串，只认 contributes.commands 数组里明确列出的 command 字段。
-
contributes.commands中每个对象的command值（如"extension.sayHello"）必须和vscode.commands.registerCommand('extension.sayHello', ...)的第一个参数完全一致，包括大小写和点号位置 -
activationEvents至少要包含对应命令的触发条件，比如"onCommand:extension.sayHello"；如果写成"onCommand:extension.helloWorld"却注册的是sayHello，插件就不会激活 - 改完
package.json后必须重载窗口（Developer: Reload Window）或重启 Extension Development Host，否则新配置不生效
src/extension.ts 里该写什么逻辑？
核心就两件事：在 activate 里注册功能，在 deactivate 里清理资源。初学者常把业务逻辑直接写在 activate 外部，结果一启动就执行，而不是等用户触发命令。
- 所有可交互功能（弹窗、编辑器操作、文件读写）都应封装在
registerCommand的回调函数里，不要放在activate函数体顶层 - 用
context.subscriptions.push()管理监听器或定时器，避免内存泄漏；例如vscode.window.onDidChangeActiveTextEditor(...)返回的对象应被 push 进去 - TypeScript 类型提示很有用，确保顶部有
import * as vscode from 'vscode';，否则vscode.window.showInformationMessage会报错
调试时看不到 console.log 或断点没反应？
VS Code 插件运行在独立的 Node.js 进程中，你看到的“主窗口”控制台（Developer Tools）是渲染进程，不是插件进程。调试必须通过 F5 启动的 Extension Development Host 窗口进行。
- F5 启动后，打开 Extension Development Host 窗口，再按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，这时看到的 DevTools 才是插件进程的 -
console.log输出默认出现在 DevTools 的 Console 面板，不是 VS Code 输出面板；想看结构化日志可用vscode.window.showInformationMessage(JSON.stringify(obj)) - 如果断点失效，检查 tsconfig.json 是否启用了
sourceMap: true（脚手架默认已开），且 launch.json 的type是pwa-extensionHost
npm run package 失败：Error: Cannot find module './out/extension.js'
这是因为 TypeScript 源码还没编译成 JS。VS Code 插件运行的是 out/ 下的 JavaScript，不是 src/ 下的 TypeScript —— 即使你用 F5 调试成功，也不代表编译步骤被跳过。
- 首次打包前必须先运行
npm run compile（或npm run watch保持监听）；部分模板也支持npm run build - 确认
package.json的main字段指向"./out/extension.js"，而不是"./src/extension.ts" - 如果用了
ts-node或其他非标准方式绕过编译，vsce打包时会失败，因为 marketplace 只接受标准 JS 输出
真正的难点不在写第一行 showInformationMessage，而在于理解 VS Code 插件是“事件驱动 + 延迟激活”的模型——它不常驻内存，也不主动执行，一切取决于你是否正确声明了 activationEvents 和 contributes，以及是否让 JS 运行时真正加载到那个 out/ 目录下。
