如何配置electron-builder使用自定义构建的Electron二进制文件

electron-builder打包时默认不会直接读取./node_modules/electron/dist下的文件，会优先拉取官方缓存的Electron二进制包，这是自定义功能丢失的直接原因，可通过以下两种方式配置解决：

方案1：配置本地路径（单项目场景推荐） #

直接在electron-builder的配置中指定自定义构建产物的路径，同时跳过官方二进制下载步骤：

• 在配置中添加electronDist字段，指向你的本地构建目录。配置可以写在package.json的build段，也可以写在独立的electron-builder.yml/electron-builder.json文件中，示例：

{
  "build": {
    "appId": "com.your.app",
    "productName": "your-app",
    "electronDist": "./node_modules/electron/dist",
    // 其余原有打包配置保持不变，比如输出目录、平台打包规则、签名配置等
  }
}

• 配置打包命令时添加环境变量，禁止electron-builder自动下载官方Electron二进制覆盖本地文件：
  • macOS/Linux环境直接在脚本中加变量：

    {
      "scripts": {
        "build": "ELECTRON_SKIP_BINARY_DOWNLOAD=1 electron-builder"
      }
    }
    

  • Windows环境如果需要跨平台兼容脚本，可以安装cross-env后编写命令：

    {
      "scripts": {
        "build": "cross-env ELECTRON_SKIP_BINARY_DOWNLOAD=1 electron-builder"
      }
    }
    

方案2：替换缓存文件（多项目复用场景推荐） #

如果多个项目都要用这套自定义Electron构建，可以直接把构建产物替换到electron-builder的默认缓存目录，不需要每个项目单独改配置：

• 找到对应系统的electron缓存路径：
  • Windows：%LOCALAPPDATA%\electron\Cache
  • macOS：~/Library/Caches/electron
  • Linux：~/.cache/electron
• 将自定义构建的Electron压缩包，按照官方包命名规则重命名：格式为electron-v{版本号}-{平台}-{架构}.zip，例如版本28.2.0、Windows x64平台的包命名为electron-v28.2.0-win32-x64.zip，放到缓存目录即可。electron-builder打包时检测到对应版本的缓存包存在，就不会重新下载官方版本。

校验配置有效性 #

执行打包命令时观察控制台输出，如果出现指向你配置的electronDist路径的相关日志，说明配置生效。打包完成后安装运行应用，验证自定义功能是否正常即可。

注意：自定义构建的Electron版本号，必须和项目package.json中声明的electron依赖版本完全一致，否则会出现版本不匹配导致的启动崩溃、API调用异常问题。

内容的提问来源于stack exchange，提问作者Bernd