VSCode --extensionDevelopment 启动失败主因是未指定有效扩展根目录路径，必须提供含合法package.json（含main或activationEvents）的本地文件夹，且路径不能为符号链接、网络路径或含空格/中文未加引号，需提前编译TS、配置正确launch.json类型为extensionHost并确保outFiles和sourceMap匹配。
vscode --extensionDevelopment 启动失败的常见原因
直接运行 code --extensionDevelopment 通常会报错或无响应，根本原因是它必须指定一个**有效的扩展根目录路径**（即含 package.json 且声明了 main 或 activationEvents 的文件夹），不能只写命令不带参数。
常见错误现象包括：Unable to read extension package、空白窗口弹出但扩展未加载、控制台提示 Extension host terminated unexpectedly。
- 确保目标目录下有合法的
package.json，且其中至少包含"main"字段（如"main": "./extension.js"） - 路径不能是符号链接或网络路径；Windows 下注意反斜杠转义问题，建议统一用正斜杠或双反斜杠
- 如果扩展依赖 TypeScript，需提前运行
tsc -w或配置好preLaunchTask，否则调试时会因 JS 文件缺失而中断
正确启动命令及必要配套操作
核心命令格式为：code --extensionDevelopment /path/to/your/extension。它会启动一个独立的 VS Code 窗口（Extension Development Host），并在该窗口中激活你的扩展。
实际使用时需配合以下操作才能真正调试：
- 在扩展项目根目录下打开终端，先执行
npm install（确保node_modules齐全） - 若使用 TypeScript，运行
tsc -b或启用"compileOnSave": true，保证生成out/或dist/下的 JS 文件 - 启动后，在新窗口中按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Developer: Toggle Developer Tools查看控制台是否有Activating extension日志 - 修改代码后，需手动重载窗口（
Ctrl+R）或点击调试侧边栏的「重启 Extension Host」按钮
调试配置 launch.json 中的常见陷阱
即使命令行能启动，断点不生效往往是因为 .vscode/launch.json 配置与实际运行环境不匹配。
典型错误配置：
-
"type": "pwa-node"但没指定"request": "launch"和正确的"program"入口（应指向编译后的 JS 文件，如"${workspaceFolder}/out/extension.js"） - 误将
"runtimeExecutable"指向系统 Node 而非 VS Code 内置 Electron 运行时——调试扩展必须用"type": "extensionHost"类型配置 - 忽略
"outFiles"设置，导致源码映射（source map）失效，断点停留在 TS 文件却无法命中 - 多根工作区下未在
launch.json中明确"cwd"，导致相对路径解析错误
Windows 下 PowerShell 权限与路径空格问题
在 Windows 上用 PowerShell 执行命令时，路径含空格（如 C:\Users\John Doe\my-ext）极易导致启动失败，错误信息常为 Cannot find module 或直接退出。
解决方式很直接：
- 用双引号包裹路径：
code --extensionDevelopment "C:\Users\John Doe\my-ext" - 避免在路径中使用中文或特殊字符，尤其不要放在 OneDrive 或 Teams 同步目录下（文件锁和权限可能导致
package.json读取失败） - 如果 PowerShell 报
Execution Policy错误，临时允许脚本执行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户，无需管理员） - 更稳妥的做法：改用 VS Code 内置终端（
Ctrl+`），它默认继承 VS Code 的 PATH 和权限上下文
扩展开发环境本身不复杂，但路径、编译产物、调试类型三者必须严格对齐；漏掉任意一环，都会表现为“看起来启动了，但扩展没反应”。
