Electron 打包太慢问题

问题描述

在 Electron 应用开发过程中，打包速度慢是一个常见且令人困扰的问题。特别是在使用 electron-builder 或其他打包工具构建 Electron 应用时：

• 下载 Electron 二进制文件速度极慢，甚至经常超时
• 下载其他依赖包（如 electron-builder-binaries）耗时过长
• 整个打包过程持续数十分钟甚至数小时
• 打包过程中经常出现网络错误或重试

原因分析

Electron 打包慢的主要原因包括：

1. 网络问题：Electron 及其依赖包的默认下载源位于国外服务器，国内用户访问速度受限
2. 文件体积大：Electron 本身是一个较大的二进制文件，完整下载需要一定时间
3. 依赖复杂：Electron 应用通常依赖多个第三方库和二进制组件
4. 缓存机制：首次打包时没有本地缓存，需要完全重新下载所有资源
5. 系统资源限制：打包过程需要大量 CPU 和内存资源，配置较低的机器会明显变慢

解决方案

方案一：配置国内镜像源

最常见的解决方案是修改 npm 配置文件，使用国内镜像源来加速下载。

方法 1：修改 .npmrc 文件

在项目根目录或用户主目录下创建或修改 .npmrc 文件，添加以下内容：

registry=https://registry.npmmirror.com/
disturl=https://registry.npmmirror.com/-/binary/node
electron_mirror=https://npmmirror.com/mirrors/electron/
electron-builder-binaries_mirror=https://registry.npmmirror.com/-/binary/electron-builder-binaries/

这些配置分别指定了：

• npm 包的国内镜像源
• Node.js 二进制文件的下载地址
• Electron 二进制文件的镜像地址
• electron-builder 所需二进制文件的镜像地址

方法 2：使用命令行设置

也可以通过 npm 命令行直接设置这些配置：

npm config set registry https://registry.npmmirror.com/
npm config set disturl https://registry.npmmirror.com/-/binary/node
npm config set electron_mirror https://npmmirror.com/mirrors/electron/
npm config set electron-builder-binaries_mirror https://registry.npmmirror.com/-/binary/electron-builder-binaries/

方案二：使用缓存机制

利用缓存可以避免重复下载相同的资源，显著提高后续打包速度。

electron-builder 缓存设置

在 package.json 中添加 electron-builder 的配置：

{
  "build": {
    "electronDownload": {
      "cache": "path/to/cache/dir"
    }
  }
}

或者设置环境变量：

# Windows
export ELECTRON_CACHE="path/to/cache/dir"

# macOS/Linux
export ELECTRON_CACHE=path/to/cache/dir

方案三：优化打包配置

合理的打包配置可以减少打包时间和输出文件体积。

1. 排除不必要的文件

在 package.json 的 build 配置中使用 files 字段明确指定需要打包的文件，或使用 .electronignore 文件排除不需要的文件：

{
  "build": {
    "files": [
      "dist/**/*",
      "node_modules/**/*",
      "package.json"
    ],
    "asar": true
  }
}

2. 使用 asar 打包

启用 asar 打包可以将多个文件合并为一个归档文件，提高打包和启动性能：

{
  "build": {
    "asar": true
  }
}

3. 并行构建

在支持的情况下，可以启用并行构建来利用多核 CPU：

{
  "build": {
    "parallel": true
  }
}

方案四：使用 Yarn 或 Pnpm

相比 npm，Yarn 和 Pnpm 具有更高效的依赖管理和缓存机制，可能会提高打包速度。

# 安装 Yarn
npm install -g yarn

# 使用 Yarn 安装依赖
rm -rf node_modules
rm package-lock.json
yarn install

# 使用 Yarn 打包
yarn run build

方案五：手动下载 Electron

对于反复出现下载超时的情况，可以考虑手动下载 Electron 二进制文件：

1. 从 Electron 镜像站 下载对应版本的 Electron
2. 将下载的文件放入 Electron 缓存目录
3. 重新执行打包命令

注意事项

1. 镜像源选择：不同地区的网络环境可能对不同镜像源的访问速度有差异，可以尝试多个镜像源
2. 配置文件位置：.npmrc 文件可以放在项目根目录（仅影响当前项目）或用户主目录（全局影响）
3. 版本兼容性：确保使用的 Electron 版本与依赖包兼容