必须用 Extension Development Host 模式调试 VS Code 插件，type 必须为 "extensionHost" 且 request 为 "launch"；插件需手动触发命令激活，sourceMap 需启用并确保 .js.map 文件存在且被 VSCode 读取。
VSCode 插件调试没反应、断点不命中、命令不出现——根本不是代码写错了，而是你没走对启动路径。必须用 Extension Development Host 模式，其他方式全是白忙。
为什么 F5 启动后插件完全没反应
现象是弹出新窗口，但命令搜不到、console.log 不输出、断点灰掉。这不是环境问题，是激活机制没触发。
-
launch.json中type必须是"extensionHost"，不是"node"；request必须是"launch" - 插件不会自动激活：如果你注册了
"onCommand:myext.doSomething"，就得在新窗口里按Ctrl+Shift+P手动输入并执行该命令，activate才会运行 -
package.json的main字段必须指向编译后的 JS 文件（如./out/extension.js），且out目录得真实存在——TypeScript 没编译就跑调试，必失败
断点打了却始终不生效
断点灰掉或点击无响应，90% 是 source map 链路断了。TypeScript 源码和运行时 JS 之间必须能准确映射。
- 确认
tsconfig.json中"sourceMap": true已开启，且编译后每个.js文件同级有对应的.js.map -
launch.json的outFiles要包含"${workspaceFolder}/out/**/*.js"，否则调试器找不到映射目标 - 别把
out目录加进.gitignore后又忘了它被 IDE 排除——VSCode 可能压根读不到.map文件 - 优先在
activate函数开头打断点，它是最稳定、最先被调用的入口；命令回调里的断点要等命令触发后才有效
离线或 CI 环境下怎么可靠测试插件逻辑
直接 import 插件源码跑 Jest？立刻报 vscode.window is undefined。VSCode API 只在 host 环境中可用。
- 纯工具函数（比如字符串处理、配置解析）可以抽到独立模块，脱离
vscode依赖后用 Jest 单测——这部分不用 mock - 涉及命令注册、配置读取、UI 弹窗等行为，必须用
@vscode/test-electron：它启动一个最小 Electron 实例，并注入 mock 的 VSCode API - 集成测试入口必须写在
test/runTest.ts，调用runTests时传入extensionDevelopmentPath和extensionTestsPath，缺一不可 - 别在
deactivate里设断点指望自动触发——它只在插件被卸载时调用，而调试过程中 VSCode 默认不会主动卸载你正在开发的插件
最常被忽略的是：你以为在调试插件，其实只是在跑一个没加载任何 extension context 的空 Node 进程。从 launch.json 类型开始查，比改十遍 extension.ts 都管用。
