调试插件前必须确认三件事：package.json中main字段指向有效入口文件、extension.js或extension.ts存在且导出activate函数、.vscode/launch.json中type为pwa-extensionHost且args含--extensionDevelopmentPath=${workspaceFolder}。
调试插件前必须确认的三件事
VSCode 插件调试不是点一下 F5 就能跑起来的事。你得先确认：package.json 里写了 "main" 入口、extension.js（或 extension.ts）存在且导出 activate 函数、项目根目录下有 .vscode/launch.json 且类型是 "type": "pwa-extensionHost"。漏掉任意一项，Debug: Start Debugging 就会静默失败，控制台连报错都不打。
常见错误现象：Extension host terminated unexpectedly、断点灰掉、console.log 完全不输出——大概率是入口路径配错，或者 launch.json 里没设 "request": "launch" 和 "args" 启动参数。
-
package.json中"main"必须指向实际存在的 JS/TS 文件，不能是构建产物目录（比如"out/extension.js"而没运行npm run compile） -
launch.json的"args"至少要包含--extensionDevelopmentPath=${workspaceFolder}，否则 VSCode 不知道该加载哪个插件 - 如果用了 TypeScript，确保
tsconfig.json的"outDir"和"rootDir"匹配，且sourceMap设为true，不然断点会偏移
为什么 launch.json 里 type 必须是 pwa-extensionHost
VSCode 2025 年后已弃用旧版 "type": "extensionHost"。现在所有插件调试都走 PWA（Progressive Web App）调试协议，底层依赖的是 js-debug（即内置的 JavaScript Debugger），它只识别 pwa-extensionHost 类型。设成 chrome 或 node，调试器根本不会 attach 到 extension host 进程上。
正确配置示例：
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-extensionHost",
"request": "launch",
"name": "Launch Extension",
"runtimeExecutable": "${execPath}",
"args": [
"--extensionDevelopmentPath=${workspaceFolder}",
"--extensionTestsPath=${workspaceFolder}/out/test"
],
"outFiles": ["${workspaceFolder}/out/**/*.js"],
"skipFiles": ["<node_internals>/**"]
}
]
}
注意："outFiles" 要和你实际编译输出路径一致；若用 ESM 输出，还得加 "resolveSourceMapLocations" 配置，否则断点映射失效。
调试 WebView 和 TreeView 时变量显示 undefined 怎么办
WebView 是独立的渲染进程，TreeDataProvider 是在 extension host 进程里执行的，两者内存隔离。你在 WebView 里打的断点，看到的 this 是 window 对象，不是你的插件类实例；你在 TreeDataProvider 里打的断点，也拿不到 WebView 里的 DOM 节点。
真正有效的调试方式只有两种：
- 在 WebView 的 HTML 中内联
<script>debugger;</script>，然后用浏览器开发者工具（F12）调试——VSCode 的调试器对 WebView 内容完全不可见 - 在
TreeDataProvider的getChildren等方法里加console.log，并在 VSCode 的Debug Console面板中查看输出（不是终端！不是 Output 面板！） - 若需跨进程通信验证，用
webview.postMessage()+webview.onDidReceiveMessage配合console.time()打点，比单步更可靠
别试图在 WebView 的 script 标签里 import 插件源码——路径解析失败，require is not defined 是必然结果。
修改插件代码后热重载失败的典型原因
VSCode 插件本身不支持 HMR（Hot Module Replacement）。每次改完代码，必须手动重启 Extension Development Host（按 Ctrl+R 或点击调试面板右上角的重启按钮），否则看到的永远是旧逻辑。
但你可以减少重启次数：
- 把可热重载的部分抽成独立模块（比如纯函数工具库），用
require.resolve+delete require.cache手动刷新，仅限 Node.js 环境下有效 - 避免在
activate里做 heavy initialization；把耗时操作延迟到命令触发时再执行，这样重启 host 后能更快进调试状态 - 如果用了 Webpack 构建，确保
devtool是"source-map"而非"eval-source-map"，后者在插件调试中常导致断点错位
最常被忽略的一点：package.json 的 "activationEvents" 如果写成 "*"，插件会在 VSCode 启动时立即激活——这意味着你改完代码重启 host，其实是在重启整个 VSCode 实例，而不是轻量级的 extension host 进程。
