本文最后更新于322 天前，其中的信息可能已经过时，如有错误请发送邮件到big_fw@foxmail.com
在使用 Electron 进行桌面应用开发时，我们通常会经历两步关键操作：
- 使用
npm install electron安装 Electron； - 使用
electron-builder打包项目。
然而，在国内开发环境下，这两个步骤经常遇到各种网络、权限、环境变量等问题。本文将结合真实案例，全面总结安装和打包过程中遇到的问题及解决方法。
一、安装 Electron 时常见问题
问题 1：卡在 npm install electron 阶段，进度条不动
npm install electron --save-dev
# 卡在某个 reify 或 downloading 状态
可能原因：
- Electron 安装过程中需要下载大文件（100MB+）的二进制；
- GitHub CDN 在中国大陆访问不稳定；
解决方案：
✅ 方式一：设置代理
如果你平时开启了 全局代理也未必生效，需手动设置环境变量：
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 : 客户端没有所需的特权
原因分析：
electron-builder会自动从 GitHub 下载 Windows 安装程序依赖（如 NSIS、winCodeSign 等）；- 在国内访问 GitHub 下载链接可能失败；
- 解压
.7z时会尝试创建符号链接（symlink），而普通用户权限不够。
解决方案：
✅ 方式一：临时设置代理环境变量
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 | 设置代理 |
| 安装失败 | 检查权限 |
| 打包失败 | 手动设置 HTTP_PROXY 环境变量 |
| 提示权限问题 | 使用管理员终端运行打包命令 |
| electron-builder 下载慢 | 配合 Clash + 代理变量 |
