如何排查VS Code扩展无法加载启动的问题？

• 检查调试控制台输出
  回到原VS Code窗口，打开调试控制台，查看是否有报错信息（比如依赖缺失、语法错误、manifest配置错误等），这是最直接的问题线索。

• 验证package.json核心配置

  • 确认activationEvents字段：比如官方示例的onCommand:hello-world，要和contributes.commands里的命令ID完全匹配，不能有拼写错误。
  • 检查main字段：确保指向正确的编译后入口文件（如./out/extension.js），若用TypeScript，先确认out目录是否存在编译产物。

• 核对launch.json调试配置
  打开.vscode/launch.json，确认：

  • type为extensionHost，request为launch
  • runtimeExecutable值为${execPath}（默认VS Code路径，自定义安装路径需手动修正）
  • args包含--extensionDevelopmentPath=${workspaceFolder}，该参数用于指定加载当前项目作为开发扩展

• 确认扩展编译状态

  • TypeScript项目需先执行npm run compile，检查是否有编译错误；若用watch模式，确保调试时watch进程已启动（终端会显示编译状态）。
  • 确认out目录下的js文件是最新的，避免因未编译导致无入口文件。

• 排查VS Code环境冲突

  • 关闭所有VS Code窗口后重新打开项目，清除可能存在的缓存问题。
  • 在launch.json的args中添加--disable-extensions，启动调试窗口时禁用其他扩展，排查是否存在扩展冲突。

• 检查文件权限
  确保项目目录及out目录具备读写权限，权限不足可能导致VS Code无法读取扩展文件。

内容的提问来源于stack exchange，提问作者Domi