如何使用electron-builder为多操作系统构建原生模块？

这个问题太常见了——原生Node.js模块和操作系统、CPU架构强绑定，默认情况下electron-builder只会在当前构建环境编译对应平台的原生模块。要实现一次触发就能为所有目标平台构建适配的原生模块，这里有几个靠谱的方案：

1. 用prebuild预编译多平台原生模块 #

prebuild可以提前为你需要的所有平台、Electron版本编译原生模块，这样electron-builder打包时会自动匹配对应平台的预编译文件，不用在构建时临时编译。

步骤很简单：

• 先安装依赖：

  npm install prebuild prebuild-install --save-dev
  

• 在package.json里加个预编译脚本，记得替换成你的Electron版本：

  "scripts": {
    "prebuild": "prebuild --all --strip --electron-version 28.0.0"
  }
  

• 先跑预编译生成全平台模块：

  npm run prebuild
  

• 最后执行你的构建命令，这时候electron-builder会自动挑对应平台的预编译文件打包。

2. 借助Docker容器实现跨平台构建 #

不想在本地折腾多环境？用Docker容器模拟不同构建环境就行。Electron官方推荐的electronuserland/builder镜像已经预装了所有依赖，甚至带Wine支持Windows构建。

举个全平台构建的命令例子：

docker run --rm -ti \
  -v ${PWD}:/project \
  -v ~/.cache/electron:/root/.cache/electron \
  -v ~/.cache/electron-builder:/root/.cache/electron-builder \
  electronuserland/builder:wine \
  /bin/bash -c "npm install && electron-builder --mac --linux --win --x64"

注意：macOS的构建可能需要签名配置，而且部分macOS专属功能在非macOS环境打包可能有兼容问题，这种情况更适合用下面的CI方案。

3. 用CI/CD平台自动化多平台构建 #

这是最省心的方案——用GitHub Actions、GitLab CI这类工具，分别在Windows、macOS、Linux的官方运行环境里执行构建任务，每个平台都会编译对应版本的原生模块，最后统一收产物。

比如在GitHub Actions里，你可以创建.github/workflows/build.yml，大致配置如下：

name: 跨平台构建
on: [push]

jobs:
  构建Windows包:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install
      - run: electron-builder --win --x64
      - uses: actions/upload-artifact@v4
        with:
          name: windows-build
          path: dist/*.exe

  构建macOS包:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install
      - run: electron-builder --mac --x64
      - uses: actions/upload-artifact@v4
        with:
          name: macos-build
          path: dist/*.dmg

  构建Linux包:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install
      - run: electron-builder --linux --x64
      - uses: actions/upload-artifact@v4
        with:
          name: linux-build
          path: dist/*.AppImage

每次推送代码，CI就会自动在三个平台完成构建，原生模块也会各自编译适配版本。

4. 调整electron-builder的重建配置 #

默认electron-builder会在构建时重新编译原生模块（针对当前平台），你可以在electron-builder.json里禁用这个行为，结合预编译模块避免冲突：

{
  "npmRebuild": false
}

这个配置会让electron-builder跳过原生模块重建，直接用你预编译好的多平台文件。

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