在使用 Electron 进行桌面应用开发时，我们通常会经历两步关键操作：

• 使用 npm install electron 安装 Electron；

• 使用 electron-builder 打包项目。

然而，在国内开发环境下，这两个步骤经常遇到各种网络、权限、环境变量等问题。本文将结合真实案例，全面总结安装和打包过程中遇到的问题及解决方法。

---

一、安装 Electron 时常见问题

问题 1：卡在 npm install electron 阶段，进度条不动

 npm install electron --save-dev
 # 卡在某个 reify 或 downloading 状态

可能原因：

1. Electron 安装过程中需要下载大文件（100MB+）的二进制；

2. GitHub CDN 在中国大陆访问不稳定；

3. 没有配置代理或代理未生效；

4. npm registry 设置成了淘宝源，但并未同步 Electron 镜像。

解决方案：

✅ 方式一：设置代理

如果你平时开启了 全局代理也未必生效，需手动设置环境变量：

 set HTTP_PROXY=http://127.0.0.1:7890
 set HTTPS_PROXY=http://127.0.0.1:7890
 npm install electron --save-dev

对于 PowerShell，请用：

 $env:HTTP_PROXY="http://127.0.0.1:7890"
 $env:HTTPS_PROXY="http://127.0.0.1:7890"
 npm install electron --save-dev

二、打包 Electron 应用时常见问题

使用 electron-builder 命令时，可能遇到如下报错：

❌ 错误 1：下载 winCodeSign 或 nsis 失败

 Get "https://github.com/electron-userland/electron-builder-binaries/releases/download/...": dial tcp: lookup github.com: no such host

❌ 错误 2：解压报错，提示权限不足

 ERROR: Cannot create symbolic link : 客户端没有所需的特权

---

原因分析：

1. electron-builder 会自动从 GitHub 下载 Windows 安装程序依赖（如 NSIS、winCodeSign 等）；

2. 在国内访问 GitHub 下载链接可能失败；

3. 解压 .7z 时会尝试创建符号链接（symlink），而普通用户权限不够。

---

解决方案：

✅ 方式一：临时设置代理环境变量

 set HTTP_PROXY=http://127.0.0.1:7890
 set HTTPS_PROXY=http://127.0.0.1:7890
 npm run build

也可以直接一行执行：

 cmd /C "set HTTP_PROXY=http://127.0.0.1:7890 && set HTTPS_PROXY=http://127.0.0.1:7890 && npm run build"

---

✅ 方式二：以管理员身份运行终端

7-Zip 解压时如果要创建软链接（特别是解压到缓存中的 Darwin 目录时），可能会提示权限不足。

• 解决方法：右键 CMD → 以管理员身份运行；

• 或使用 PowerShell（管理员）。

---

✅ 判断打包是否成功

若打包成功，会看到日志中包含如下信息：

 • building        target=nsis file=dist\项目名 Setup 1.0.0.exe archs=x64
 • building block map

并且在 dist/ 文件夹下会生成 .exe 安装文件。

---

📌 小结与建议

操作	建议
安装 electron	使用 npmmirror 镜像或设置代理
安装失败	清理缓存后重试，或检查权限
打包失败	手动设置 HTTP_PROXY 环境变量
提示权限问题	使用管理员终端运行打包命令
electron-builder 下载慢	配合 Clash + 代理变量