VSCode调试扩展时code --extensionDevelopment不生效，根本原因是路径未指向含package.json的源码根目录，或TypeScript未编译、sourceMap配置不匹配，导致扩展静默失败。
vscode 调试扩展时为什么 code --extensionDevelopment 不生效
常见现象是执行命令后 VSCode 启动了，但扩展没加载、断点不触发、console.log 无输出。根本原因通常是路径错误或工作区未正确指定——--extensionDevelopment 后必须跟**扩展源码根目录**（即含 package.json 和 src/ 的那个文件夹），而不是当前 shell 所在路径或打包后的 .vsix。
实操建议：
- 确保该目录下存在有效的
package.json，且含"main"字段指向入口 JS/TS 文件 - 如果扩展使用 TypeScript，先运行
npm run compile或npm run watch，否则调试器会因找不到out/下的 JS 文件而静默失败 - 不要加引号包裹路径，除非含空格；Windows 用户注意用正斜杠或双反斜杠，例如
code --extensionDevelopment C:/my-ext
如何让调试窗口自动打开扩展的 launch 配置
VSCode 不会自动读取你项目里的 .vscode/launch.json，除非你显式指定 --extensionTests 或手动在调试面板里选环境。更可靠的做法是：启动调试实例后，立刻按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），输入 Developer: Open Extension Development Host 确认——这会强制打开一个已预载你扩展的独立窗口，此时再按 Ctrl+Shift+D 切到调试视图，选择「Extension」配置即可开始调试。
关键细节：
-
launch.json必须放在扩展项目根目录下的.vscode/中，且配置类型为"type": "extensionHost" - 若用 TS，
outFiles要指向编译后路径，比如"outFiles": ["${workspaceFolder}/out/**/*.js"] - 避免复用主 VSCode 的用户级
launch.json，它对扩展开发实例无效
调试时断点不命中？检查 sourceMap 和 outFiles 是否匹配
TS 扩展最常卡在这步：明明代码里打了断点，调试器却跳过。本质是 VSCode 找不到源码映射关系。必须同时满足三个条件：tsc 编译时生成 .map 文件、launch.json 中 outFiles 正确声明输出路径、sourceMaps 设为 true。
验证步骤：
- 检查
out/目录下是否有同名.js.map文件（如extension.js.map） - 在
launch.json中确认"sourceMaps": true和"outFiles"指向真实存在的 JS 文件（不是 glob 模式误写成"**/*.js"） - 如果用了 webpack 或 esbuild，需额外配置 sourcemap 输出，并在
launch.json中用webRoot或resolveSourceMapLocations修正路径
调试扩展时修改代码要重新加载，但 Ctrl+R 没反应怎么办
开发主机窗口默认禁用热重载，Ctrl+R 只刷新 UI，不重载扩展逻辑。真正生效的是「Developer: Reload Window」命令（Ctrl+Shift+P → 输入 reload → 回车），或者更高效的方式：在调试侧边栏点击「Restart」按钮（绿色循环箭头），它会终止当前 extension host 进程并重启，同时保留断点和调试会话状态。
注意边界情况：
- 如果扩展注册了
onStartupFinished或依赖全局状态，重启后可能需要手动触发初始化逻辑 - 某些扩展（如含 WebView 或 Language Server）需额外调用
Developer: Toggle Developer Tools查看控制台错误，因为console.error不总显示在调试面板 - 频繁重启时，观察 DevTools 的
Console面板是否出现Extension host terminated unexpectedly，这往往意味着activate()抛异常且未被try/catch捕获
扩展调试真正的复杂点不在命令本身，而在路径、编译产物、sourcemap 三者之间的隐式耦合——任何一个环节的路径多一级、少一级、斜杠方向错，都会导致“看起来启动了，实际没跑”。建议把 code --extensionDevelopment 命令固化为 npm script，配合 pretest 自动编译，减少手误。
