运行项目时持续提示:
Electron failed to install correctly, please delete node_modules/electron and try installing again
即使多次删除并重装Electron,问题仍存在。
排查步骤
- 
基础操作 - 删除 node_modules/electron文件夹,重新安装Electron(npm install electron)。
- 尝试升级/降级Electron版本(如从v7降级到v6)。
 
- 删除 
- 
依赖与缓存检查 - 清除npm缓存(npm cache clean --force)。
- 检查全局环境变量和权限问题(如Windows需以管理员身份运行命令)。
 
- 清除npm缓存(
- 
网络问题验证 - 确认能否正常访问Electron官方下载源(https://github.com/electron/electron/releases)。
- 若网络受限,尝试配置镜像源(如淘宝镜像:npm config set ELECTRON_CUSTOM_VERSION https://npmmirror.com/mirrors/electron/)。
 
- 确认能否正常访问Electron官方下载源(
- 
手动干预安装 - 
运行Electron内置安装脚本: bashnode node_modules/electron/install.js
- 
若脚本执行失败,手动下载对应版本的Electron压缩包(如 electron-v7.0.0-win32-x64.zip),解压至node_modules/electron/dist,并创建path.txt文件指定可执行文件路径(如填写electron.exe)。
 
- 
根本原因
- 网络中断或镜像失效
- 下载Electron二进制文件时,因网络波动或镜像源不可用导致文件缺失或损坏。
 
- 安装脚本未自动执行
- install.js未能成功触发下载流程(如超时或权限不足),导致关键文件(如- path.txt)未生成。
 
- 缓存残留
- 旧版本缓存未彻底清除,干扰新版本安装。
 
解决方案总结
| 场景 | 解决方法 | 适用版本 | 
|---|---|---|
| 网络问题 | 使用镜像源或手动下载压缩包 | 所有版本 | 
| 安装脚本失败 | 手动执行 node node_modules/electron/install.js | v7+ | 
| 文件缺失 | 手动解压二进制包并创建 path.txt | v6/v7 | 
| 权限问题 | 以管理员权限运行命令或修改文件夹权限 | Windows/macOS |