VSCode插件调试本质是调试extensionHost进程，必须配置"type": "extensionHost"和"request": "launch"，通过--extensionDevelopmentPath指定插件路径，并确保sourceMap、编译输出与outFiles路径一致。
VSCode插件调试本质是调试一个 Node.js 进程
VSCode 插件本身就是用 TypeScript/JavaScript 编写的，运行在 VSCode 启动的独立 Node.js 子进程中（extensionHost）。这意味着你不能像调试网页那样直接打开 DevTools，而必须通过 VSCode 自带的调试器 Attach 到该进程。一旦理解这点，很多“断点不命中”“变量看不到”的问题就自然有解了。
关键操作路径：启动插件时，VSCode 会自动启用 extensionHost 调试通道；你只需在自己的插件项目中配置好 .vscode/launch.json，并确保 "type": "extensionHost" —— 这不是可选，是必须。
- 不要手动去 Chrome DevTools 里找插件代码，它不在渲染进程里
- 不要在插件源码里加
debugger然后指望浏览器断住，基本无效 - 确保插件已启用（检查状态栏右下角是否有插件图标或提示）
- 首次调试前，先按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，确认控制台无Cannot find module类错误
launch.json 配置必须包含两个核心字段
很多调试失败，根源在于 launch.json 少了 "request": "launch" 或漏掉 "args" 中的插件路径。VSCode 不会自动猜你当前要调试哪个插件，必须显式指定入口。
最简可用配置如下：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Extension",
"type": "extensionHost",
"request": "launch",
"args": [
"--extensionDevelopmentPath=${workspaceFolder}",
"--extensionTestsPath=${workspaceFolder}/out/test"
],
"outFiles": ["${workspaceFolder}/out/**/*.js"],
"preLaunchTask": "npm: compile"
}
]
}
-
"args"是硬性要求：缺--extensionDevelopmentPath就等于没告诉 VSCode “我要调试这个文件夹下的插件” -
"outFiles"必须匹配实际编译输出路径，TypeScript 项目默认是out/**，若你用dist/就得同步改 -
"preLaunchTask"建议绑定编译任务，否则修改 TS 后直接调试，跑的还是旧 JS - 如果插件含 UI（Webview），还需额外加
"webRoot": "${workspaceFolder}"才能调试 Webview 内 JS
常见断点失效的三个真实原因
不是代码写错了，而是环境没对齐。VSCode 插件调试对路径、时序、编译产物三者一致性极其敏感。
- TS 源码打了断点，但实际运行的是未更新的
out/下旧 JS 文件 → 检查npm run compile是否真执行成功，看终端最后是否输出Found 0 errors - 断点打在
activate()里却从不触发 → 插件未被正确加载，检查package.json的"activationEvents"是否匹配你的触发方式（比如用了"onCommand:myExtension.doSomething"，但你没注册该命令） - 断点进了，但
this或局部变量显示undefined→ 源码映射（source map）未生效，确认tsconfig.json中"sourceMap": true且"outDir"与launch.json的"outFiles"一致
调试 Webview 或 WebViewPanel 时容易忽略的细节
Webview 是运行在隔离 iframe 中的独立上下文，它的 JS 不受主插件进程调试器直接管控。想断点调试 Webview 里的逻辑，必须走另一套流程。
- 不能在 Webview 的 HTML/JS 文件里直接打 VSCode 断点，那只是静态文件
- 必须在 Webview 加载完成后，调用
webviewPanel.webview.debugger.attach()（需开启enableScripts: true） - 更稳妥的做法：在 Webview 的 HTML 中加
<script>debugger;</script>，然后按Ctrl+Shift+I打开 Webview 自带的 DevTools（右键 Webview → “Inspect”） - 注意 CSP 限制：若 Webview 报
Refused to execute inline script，需在webviewPanel.webview.html中显式设置content-security-policymeta 标签
extensionHost 进程的生命周期、源码映射链路和 Webview 上下文边界。这三个地方一卡住，90% 的“调试不了”问题就出在这儿。 
