如何将Electron项目打包为Windows单文件便携可执行程序？

方法一：使用electron-builder配置单文件便携包 #

electron-builder本身支持生成单文件便携版EXE，你之前未成功大概率是配置项未设置正确，具体步骤如下：

1. 安装依赖
   进入项目目录，执行命令安装electron-builder：

npm install electron-builder --save-dev

2. 修改package.json配置
   在package.json中添加build字段，指定Windows单文件便携配置：

"build": {
  "appId": "com.example.electron-quick-start",
  "win": {
    "target": "portable",
    "portable": {
      "artifactName": "${productName}.exe"
    },
    "asar": true
  }
}

• target: "portable"：指定生成便携版，该版本为单文件且无需依赖额外目录
• asar: true：将应用代码打包成asar归档，减少文件数量并保证单文件运行
• artifactName：自定义生成的EXE文件名

3. 执行打包
   在package.json的scripts中添加打包命令：

"scripts": {
  "start": "electron .",
  "package": "electron-builder"
}

运行命令启动打包：

npm run package

打包完成后，dist目录下会生成独立的EXE文件，直接运行即可，无需依赖其他文件。

方法二：使用electron-packager配合asar压缩（备选） #

若electron-builder不符合需求，可通过electron-packager结合asar将所有资源嵌入EXE：

1. 安装依赖

npm install electron-packager asar --save-dev

2. 执行打包命令
   运行以下命令，指定Windows平台并启用asar压缩：

npx electron-packager . "ElectronQuickStart" --platform=win32 --arch=x64 --asar --out=dist --overwrite

• --asar：将应用源代码和资源打包成asar文件，嵌入到EXE中
• 打包后生成目录内的EXE可直接运行，若应用包含原生模块，需额外处理适配，但基础项目如electron-quick-start无此问题。

注意事项 #

• 确保Electron版本与打包工具版本兼容，避免版本不匹配引发异常
• 若应用包含外部资源（如图片、音频），需确保其被正确纳入asar包，electron-builder默认会打包项目根目录所有文件，除非在build.files中手动排除
• 单文件EXE首次运行时会自动将临时文件解压至系统临时目录，运行结束后自动清理，不会残留系统文件

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