Electron 打包与分发
Electron 中的打包与分发
打包是将 Electron 应用从开发环境转换为可分发的独立桌面安装包的过程（Windows: .exe/.msi；macOS: .dmg/.app；Linux: .deb/.rpm/.AppImage）。官方推荐使用成熟的打包工具，避免手动操作。以下基于 2025 年最新实践总结。
1.主流打包工具对比
| 工具 | 优点 | 缺点/注意事项 | 支持平台 | 推荐场景 |
|---|---|---|---|---|
| electron-builder | 配置最简单、功能最全（自动更新、代码签名、多种格式、多语言安装器） | 依赖较多，偶尔配置复杂 | Win/mac/Linux | 首选，大多数项目 |
| electron-forge | 官方推荐，模块化（支持多种 maker），与 Webpack/Vite 集成好 | 配置稍繁琐，自动更新需额外插件 | Win/mac/Linux | 喜欢模块化、需要自定义流程 |
| electron-packager | 最轻量、简单快速 | 只打包不生成安装器，需手动签名/公证 | Win/mac/Linux | 快速原型、内部分发 |
| electron-updater + builder | 与 builder 结合实现自动更新 | - | - | 所有需要自动更新的应用 |
2025 年推荐：electron-builder（社区最活跃，文档最全）。
2.使用 electron-builder 打包（推荐流程）
安装：
npminstall--save-dev electron-builderpackage.json 配置（关键部分）：
{"name":"my-app","version":"1.0.0","main":"main.js","scripts":{"build":"electron-builder","dist:win":"electron-builder --win","dist:mac":"electron-builder --mac","dist:linux":"electron-builder --linux"},"build":{"appId":"com.example.myapp","productName":"MyApp","directories":{"output":"dist"// 输出目录},"files":["dist-electron/**/*",// Vite/Webpack 输出"main/**/*"],"win":{"target":[{"target":"nsis","arch":["x64","ia32"]},// 安装器{"target":"portable"}// 便携版],"icon":"build/icon.ico"},"mac":{"target":["dmg","zip"],"icon":"build/icon.icns","hardenedRuntime":true,"gatekeeperAssess":false,"entitlements":"build/entitlements.mac.plist"},"linux":{"target":["AppImage","deb","rpm"],"icon":"build/icons"},"nsis":{"oneClick":false,// 多语言安装器"allowToChangeInstallationDirectory":true}}}常见打包命令：
# 打包所有平台npmrun build# 只打包当前平台npmrun build -- --publish never# 发布（配合自动更新）npmrun build -- --publish always3.代码签名与公证（必须，用于生产发布）
| 平台 | 要求 | 操作方式 |
|---|---|---|
| Windows | SmartScreen 信任、病毒扫描 | 使用 EV 代码签名证书（DigiCert、Sectigo）CSC_LINK和CSC_KEY_PASSWORD环境变量 |
| macOS | Gatekeeper、Notarization（公证）必备 | - Apple Developer ID 证书 - 启用 Hardened Runtime - electron-builder 自动公证（需 APPLE_ID和APPLE_ID_PASSWORD） |
| Linux | 无强制，但 AppImage 可签名 | 可选 GPG 签名 |
4.自动更新（Squirrel / electron-updater）
推荐使用electron-updater（与 builder 无缝集成）。
配置：
npminstallelectron-updater主进程代码：
const{autoUpdater}=require('electron-updater');autoUpdater.on('checking-for-update',()=>{/* ... */});autoUpdater.on('update-available',()=>{/* 提示用户 */});autoUpdater.on('update-downloaded',()=>{autoUpdater.quitAndInstall();});// 启动时检查app.whenReady().then(()=>{autoUpdater.checkForUpdatesAndNotify();});发布服务器选项：
- GitHub Releases（最简单，private repo 也支持）
- S3 / Azure / 自建服务器
- Electron 的官方发布服务（如 Nutstore）
builder 配置（package.json）：
"publish":[{"provider":"github","owner":"yourname","repo":"my-app"}]5.最佳实践与常见坑
- 开发 vs 生产：使用
vite build/webpack先构建前端资源，再打包 Electron。 - ASAR 打包：默认启用，保护源码（但非加密）；敏感代码可混淆或用 bytenode。
- 体积优化：排除 devDependencies；使用
prune；压缩 executable（UPX）。 - 跨平台构建：推荐 CI（如 GitHub Actions）：
- Windows/macOS runner 构建对应平台
- Linux 用 Docker
- 版本管理：每次发布前递增
version，否则更新检测失败。 - 测试安装包：在干净虚拟机中测试安装、卸载、更新流程。
使用 electron-builder + electron-updater + GitHub Releases 的组合，是当前最成熟、最省心的打包与分发方案。如果你的项目使用 Vite + React/Vue 或有特殊需求（如企业内部分发、自定义安装器），可以提供更多信息，我可以给出更精确的配置示例！