VSCode插件调试必须使用Extension Development Host模式，F5启动后无响应是因为未触发activationEvents（如未执行注册命令），断点需设在activate函数或命令回调中并确保sourceMap正确配置。
VSCode 插件本身不能用普通 Node.js 调试方式直接 attach，必须走 Extension Development Host 模式——这是唯一能触发 activate、正确加载 package.json 中 contributes 和 activationEvents 的路径。
为什么 F5 启动后插件没反应？
常见现象：点击调试按钮，弹出新窗口（Extension Development Host），但你的插件命令不出现、断点不命中、console.log 完全没输出。
- 根本原因不是代码写错了，而是没在 Extension Development Host 窗口中触发激活事件——比如你注册了
"onCommand:hello-world.sayHello"，但没手动执行该命令，activate就不会完整运行 -
launch.json中的request必须是"launch"，且type必须为"extensionHost"；用"node"类型只会启动一个孤立进程，无法加载插件上下文 - 确保项目根目录有有效的
package.json，其中main字段指向正确的入口文件（如./out/extension.js），且out目录已由 TypeScript 编译生成
如何让断点真正生效？
断点打在 activate 函数里最可靠，但前提是它被调用；打在命令回调里也行，但需先在 Extension Development Host 窗口中通过 Ctrl+Shift+P 输入命令名来触发。
- TypeScript 源码断点依赖
sourceMap：确认tsconfig.json中sourceMap为true，且编译后.js文件同级存在.js.map - 不要在
deactivate里设断点并指望它自动触发——它只在插件卸载时调用，而 VSCode 默认不会自动卸载你正在调试的插件 - 如果断点灰掉（unbound），检查
out目录是否被 gitignore 掉导致调试器找不到映射文件；或者确认launch.json的outFiles是否包含"${workspaceFolder}/out/**/*.js"
测试插件逻辑要不要写单元测试？
要，但别用 Jest 或 Vitest 直接 import extension.ts——VSCode API（如 vscode.window、vscode.workspace）在非 host 环境下是 undefined，会直接报错。
- 官方推荐方案是使用
@vscode/test-electron：它会启动一个最小化 Electron 实例，注入 mock 的 VSCode API，让你能真实模拟命令注册、配置读取等行为 - 简单逻辑（如纯工具函数）可抽离到独立模块，脱离
vscode依赖后用 Jest 单独测，这部分不需要 mock - 集成测试（比如验证命令执行后是否弹出消息框）必须走
@vscode/test-electron，且需在test/runTest.ts中调用runTests并传入extensionDevelopmentPath和extensionTestsPath
调试失败时优先检查这三处
很多问题卡在环境链路断裂，而不是代码本身：
-
package.json的activationEvents写成了"*"以外的值（如"onCommand:xxx"），但你没在 Dev Host 窗口执行该命令，插件就永远不激活 -
tsconfig.json的outDir和rootDir配置错误，导致编译输出路径和launch.json中的outFiles不匹配，sourceMap 失效 - 用了 TypeScript 5.4 的装饰器，但
tsconfig.json没开experimentalDecorators和emitDecoratorMetadata，编译后装饰器丢失，插件注册失败
