记一次 Electron 安装失败的“破案”经历：Error: Electron failed to install correctly

在搭建 Electron 项目时，执行 pnpm start 却撞上了经典的报错。这通常意味着 Electron 的二进制外壳没有被正确下载到本地。

1. 现场还原：报错信息

Bash

Error: Electron failed to install correctly, please delete node_modules/electron and try installing again
    at getElectronPath (...\node_modules\electron\index.js:17:11)

2. 深度剖析：为什么会失败？

经过排查，我发现这次失败是新版工具链特性与网络环境共同导致的：

• pnpm 10 的安全机制：pnpm 10 默认会忽略依赖包的 postinstall 脚本。而 Electron 正是靠这个脚本来下载其庞大的二进制可执行文件的。脚本没跑，核心文件自然缺失。
• 缺少 path.txt：Electron 的入口文件会寻找 path.txt 来定位 .exe。由于安装没走完，这个关键路径文件和 dist 目录都没有生成。
• 网络阻碍：在没有配置国内镜像的情况下，手动执行安装脚本往往会因为连接 GitHub 失败而中途夭折。

🛠️ 解决方案 (Quick Fix)

如果你发现 pnpm install 后 Electron 无法启动，请依次执行以下命令：

1. 设置镜像环境变量 (PowerShell)

首先，通过环境变量告知安装脚本从国内镜像源下载二进制文件：

PowerShell

$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

2. 手动触发安装脚本

直接运行 Electron 目录下的安装程序，强制补全缺失的二进制文件：

PowerShell

node node_modules/electron/install.js

🔍 为什么这样有效？

• 注入镜像源：默认下载地址指向 GitHub Releases，在国内网络环境下极易超时。通过 $env:ELECTRON_MIRROR 指向 npmmirror (淘宝镜像) ，下载速度可从几十 KB/s 提升至数 MB/s。
• 手动补全：install.js 的核心逻辑是检测 node_modules/electron/dist 目录。如果该目录为空或不完整，它会重新下载并生成 path.txt。只要这个脚本成功跑完，pnpm start 就能正常寻找到执行入口。