首次开发VSCode扩展运行报错，已安装Node.js和Git仍无法解决

算力阿峰

2026-8-15

VSCode扩展运行报错的解决排查方案

从报错截图可知，系统找不到./out/extension.js文件，这是VSCode扩展开发初期最常见的问题——代码未完成编译或编译路径配置错误。

先补全依赖安装
打开项目根目录的终端，执行：
```
npm install
```
确保所有开发依赖（比如TypeScript、vscode等）都安装完成，无报错。
手动执行编译命令
因为VSCode扩展默认用TypeScript开发，必须编译为JavaScript才能运行，执行：
```
npm run compile
```
执行后检查项目根目录是否生成out文件夹，且其中包含extension.js文件。
校验配置文件路径
1. 打开package.json，确认main字段值为./out/extension.js，与编译后文件路径一致；
2. 打开.vscode/launch.json，确认program字段指向${workspaceFolder}/out/extension.js。
清理缓存重新编译
如果之前编译有残留问题，执行：
```
npm run clean
npm run compile
```
检查Node.js版本
VSCode扩展要求Node.js版本≥14.x，执行node -v查看版本，若版本过低，升级至LTS版本（如18.x、20.x）。