调试vscode插件前必须确认三件事：一要安装vscode-extension-tester或@vscode/test-electron；二要确保package.json中main字段指向正确入口文件；三必须用code --extensiondevelopmentpath启动独立开发实例。
调试插件前必须确认的三件事
VSCode 插件本身是 Node.js 程序，调试它不是调用 F5 就能直接进断点的事。不提前检查环境，90% 的失败都卡在这几步。
- 确保你已安装
vscode-extension-tester（用于 UI 测试）或至少有@vscode/test-electron（用于启动测试版 VSCode 实例）；纯本地开发可先跳过，但发布前必须补上 - 项目根目录下必须有
package.json，且其中main字段指向正确的入口文件（如./extension.js），否则调试器找不到启动逻辑 - 不要在用户全局安装的 VSCode 里直接调试——必须用
code --extensionDevelopmentPath=/path/to/your/extension启动一个干净的开发实例，否则会混入你日常插件的副作用
launch.json 中最易错的配置项
VSCode 调试插件依赖 .vscode/launch.json，但几个字段稍不注意就会导致“断点灰掉”或“调试器连不上”。
-
type必须是extensionHost，不是node或pwa-node；后者只能调试插件里的工具函数，无法触发激活事件 -
request必须为launch，不能写成attach——除非你真在 attach 到一个已运行的扩展主机进程（极少见） -
runtimeExecutable要显式指定 VSCode 可执行路径，macOS 上常被忽略为code，实际应为/Applications/Visual Studio Code.app/Contents/MacOS/Electron；Windows/Linux 同理需填绝对路径，否则调试器可能拉起错误版本 - 如果插件用了 Webview 或 WebViewPanel，记得加
"webRoot": "${workspaceFolder}"，否则 DevTools 里看不到源码映射
为什么断点进了却拿不到变量？
这不是调试器问题，而是 VSCode 插件生命周期和模块加载机制导致的典型现象。你在 activate 函数里打的断点，可能早于语言服务器、配置读取甚至 package.json 的 contributes 解析完成。
- 优先在
extension.js的顶层作用域加console.log('loaded')，确认模块确实被加载；若没输出，说明main路径错或activationEvents配置拦截了自动激活 - 不要在
activate里直接操作未初始化的 API，比如vscode.window.showInformationMessage在某些测试环境里会返回undefined，要 wrap 在vscode.window.onDidOpenTerminal这类事件后才安全 - 使用
vscode.env.appName或vscode.version前，务必确认它们在当前调试上下文中可用——CI 环境或旧版 VSCode 可能返回空字符串或抛出TypeError
调试 C++ 插件（如 cpptools）的特殊路径
如果你不是写 JS/TS 插件，而是基于 cpptools 或其他原生模块开发（比如封装 clangd），调试链路会多一层：Node.js → Native Addon → Language Server。
- 必须启用
sourceMapPathOverrides映射，否则 C++ 源码路径在 JS 调试器里显示为webpack:///./src/…，根本无法关联到真实文件 - 调试
clangd子进程时，不能只靠 VSCode 的 extensionHost 配置；需额外在launch.json中添加"processId": 0并配合lldb/gdb单独 attach，或者改用--log-file输出到磁盘再分析 -
ms-vscode.cpptools的调试日志默认关闭，需手动在设置中开启cpp.loggingLevel为Debug，且日志路径藏在${env:HOME}/.vscode/extensions/ms-vscode.cpptools-*/logs，不是.vscode工作区目录下
console.log 当成你的第一调试器，比断点更早、更稳、更不挑环境。
