VSCode插件调试必须用type: "pwa-node"（非"node"），且program必须指向"${workspaceFolder}/out/extension.js"，否则断点不命中、require报错、this.extensionPath为undefined；因老式"node"调试器不支持ES模块、source map映射及现代协议，而"pwa-node"是官方专为TS编译输出和插件生命周期设计的下一代适配器。
直接说结论：VSCode插件调试必须用 type: "pwa-node"（不是 node），且 program 必须指向 ./out/extension.js，否则断点不命中、require 报错、this.extensionPath 为 undefined —— 这些不是环境问题，是配置错位导致的必然结果。
为什么 type 不能写 node 而必须是 pwa-node
VSCode 插件运行在 Electron 渲染进程 + Node.js 后台线程混合环境中，老式 node 调试适配器不支持 ES 模块、source map 映射、动态 import() 和现代调试协议。而 pwa-node 是 VSCode 官方维护的下一代调试适配器，专为 TypeScript 编译输出（out/）和插件生命周期设计。
常见错误现象：
– 断点灰色不可用，hover 提示 “Breakpoint ignored because generated code not found”
– 控制台报 Error: Cannot find module 'vscode'（实际是路径解析失败）
– debugger 语句完全被跳过
实操建议：
– 检查已安装扩展：确保 ms-vscode.js-debug 已启用（它提供 pwa-node）
– 不要手动降级或禁用该扩展
– launch.json 中 "type": "pwa-node" 必须全小写，大小写敏感
program 和 out/extension.js 的路径陷阱
插件源码是 src/extension.ts，但调试时绝不能设 "program": "${workspaceFolder}/src/extension.ts"。TS 文件必须先编译，调试器只认 JS 输出。VS Code 插件项目默认使用 npm run compile 或 npm run watch 输出到 out/ 目录，program 就得指这里。
容易踩的坑：
– 写成 "program": "${workspaceFolder}/out/extension.ts"（后缀错了，是 .js）
– 写成 "program": "./out/extension.js"（相对路径在某些工作区下会失效）
– 忘记先运行编译：npm run compile 或保存 TS 文件触发 watch 构建
正确写法：
– "program": "${workspaceFolder}/out/extension.js"
– 配合 "preLaunchTask": "npm: compile"（需在 tasks.json 中定义该 task）
– 若用 ts-node 直接跑 TS，调试行为不可靠，不推荐
env、args 和 extensionDevelopmentPath 的协同逻辑
插件调试本质是启动一个“带插件加载能力”的新 VSCode 实例。这个实例需要知道去哪里找你的插件代码，靠的是 extensionDevelopmentPath 参数，它必须通过 args 传入，不能塞进 env。
典型错误配置：
– 把 --extensionDevelopmentPath 写进 env → 完全无效
– 漏掉 --extensionTests（测试模式下必须）→ 插件不激活
– args 中路径用了相对路径 → 新窗口找不到插件目录
关键参数组合：
– "args": ["--extensionDevelopmentPath=${workspaceFolder}", "--extensionTests=${workspaceFolder}/out/test"]
– "env": {"NODE_ENV": "development"}（仅影响插件内部逻辑，不影响加载）
– "console": "integratedTerminal"（方便看插件输出日志）
– "cwd": "${workspaceFolder}"（保证 vscode.workspace.getConfiguration() 等 API 正常读取根目录配置）
调试控制台里 this.extensionPath 为什么是 undefined
这不是 bug，是调试器没正确挂载插件上下文。根本原因只有两个：
– program 指向了错误入口（比如指向了 package.json 或空文件）
– args 没传 --extensionDevelopmentPath，导致新 VSCode 实例压根没加载你的插件
验证方法：
– 启动调试后，新弹出的 VSCode 窗口左下角应显示 “Extension Development Host”
– 打开命令面板（Ctrl+Shift+P），输入 “Developer: Toggle Developer Tools”，在 Console 里执行 vscode.extensions.getExtension('your-publisher.your-extension')，返回对象才正常
– 如果返回 null，说明插件根本没注册，回头检查 args 和 program
真正容易被忽略的一点：插件调试时，所有断点必须打在 out/ 下的 JS 文件里（哪怕你用 TS 写），因为 source map 映射依赖构建时生成的 .js.map 文件是否完整、路径是否匹配。删了 out/ 又没重新编译，就只剩 undefined。
