vscode插件调试需在隔离的扩展开发主机窗口中运行，主窗口仅作控制；type必须为"extensionhost"以正确注入插件并触发activate()，断点和console.log均在此窗口的开发者工具中查看。
VSCode插件调试不是“启动F5就完事”，它依赖一个隔离的扩展开发主机（Extension Development Host）窗口来加载你的插件代码，而主窗口只负责调试控制——不理解这点，90% 的断点不命中、console.log 不输出、命令注册失败问题都源于此。
为什么 launch.json 里 type 必须是 extensionHost
VSCode 插件运行在独立的渲染进程（extension host process）中，不是普通 Node.js 进程，也不是你编辑的源码直接执行。调试器必须通过 DAP 协议连接到这个进程，而非本地文件系统。
-
type: "extensionHost"告诉 VSCode 启动一个专用的开发主机窗口，并将你的插件注入其中；用node或chrome类型会完全绕过插件生命周期，导致activate()根本不调用 - 默认生成的
launch.json中，request是launch，但如果你改成了attach，必须手动在开发主机窗口按Ctrl+Shift+P→Developer: Toggle Developer Tools打开 DevTools，再在 Sources 面板里手动加载 sourcemap，否则断点无效 - 路径配置关键：
"program": "${workspaceFolder}/src/extension.ts"是错的——TS 源码不会被直接执行，真正加载的是编译后的out/extension.js，所以"program"字段应留空或删除，靠"outFiles"和"sourceMaps"联动定位
断点不触发？先检查 package.json 的 activationEvents
VSCode 默认懒加载插件：只有满足 activationEvents 条件时才调用 activate()。写死 "*" 虽然方便测试，但发布前必须收敛——否则用户一打开 VSCode 就加载你的插件，拖慢启动速度。
- 常见误配：
"onCommand:my-extension.doSomething"写成了"onCommand:doSomething"，少前缀导致命令注册后永远无法激活 - 调试时想强制触发，可在开发主机窗口按
Ctrl+Shift+P输入你的命令全名（如My Extension: Insert Date），如果命令没出现在列表里，说明contributes.commands和activationEvents不匹配，或registerCommand调用被 try/catch 吞掉没报错 - 临时调试可设为
"*"，但上线前务必改成精确事件，比如"onLanguage:typescript"或"onView:my-custom-view"
console.log 输出去哪儿了？别在主窗口找
插件里的 console.log 默认输出到开发主机窗口的「开发者工具 → Console」面板，不是主窗口的「调试控制台」，也不是集成终端。
- 开发主机窗口右上角菜单 →
Help → Toggle Developer Tools，切到 Console 标签页才能看到日志；主窗口的调试控制台显示的是调试器自身状态（比如变量求值结果），和插件运行无关 - 如果日志完全不出现，先确认
out/extension.js是否已生成（运行npm run compile或开启 TS 监听模式npm run watch）；未编译的 TS 文件不会被加载 - 想把日志也输出到调试控制台，可用
vscode.window.showInformationMessage()或vscode.window.createOutputChannel()创建专用通道，后者支持appendLine()，适合长日志追踪
热重载失效？restart 不等于 reload
按 Ctrl+R 或点击开发主机窗口的刷新按钮，只是重新加载 UI，不会重启 extension host 进程，因此新代码不会生效；真正的热重载依赖 TypeScript 编译 + 主机进程自动重启机制。
- 确保
tsconfig.json中"outDir"指向out，且"sourceMap"为true；否则即使代码变了，调试器找不到映射关系，断点仍停在旧位置 - 推荐调试流程：启动 F5 → 修改
src/extension.ts→ 保存 → 等右下角弹出「Extension has been reloaded」提示 → 再触发命令验证逻辑；如果没提示，检查package.json的"main"字段是否指向out/extension.js - 遇到诡异状态（比如旧逻辑还在执行），不要反复刷新，直接关掉整个开发主机窗口，再按 F5 重新启动调试会话——这是最干净的重置方式
插件调试真正的难点不在语法或配置，而在于时刻分清「谁在哪个进程里运行」：主窗口是控制器，开发主机是沙盒，activate() 是入口守门人，console.log 是沙盒里的声音。漏掉任一环，调试就变成猜谜。
