Electron 离线环境打包解决方案（electron-forge）

1.在线环境准备

1. 创建新项目：

# 创建并进入项目目录
mkdir my-electron-app && cd my-electron-app# 初始化项目
npm init -y# 安装 electron
npm install --save-dev electron# 安装 electron-forge
npm install --save-dev @electron-forge/cli @electron-forge/maker-squirrel @electron-forge/maker-zip @electron-forge/maker-deb @electron-forge/maker-rpm# 使用 electron-forge 转换项目
npx electron-forge import

2. 下载所需的离线资源包：

# 在项目根目录创建离线资源文件夹
mkdir electron-offline-packages
cd electron-offline-packages# 下载需要的 npm 包
npm pack electron
npm pack @electron-forge/cli
npm pack @electron-forge/core
npm pack @electron-forge/maker-squirrel
npm pack @electron-forge/maker-zip
npm pack @electron-forge/maker-deb
npm pack @electron-forge/maker-rpm# 下载 Electron 二进制文件
# 从 https://npmmirror.com/mirrors/electron/ 下载对应版本
# 例如下载 v25.9.8 版本:
wget https://npmmirror.com/mirrors/electron/25.9.8/electron-v25.9.8-win32-x64.zip
wget https://npmmirror.com/mirrors/electron/25.9.8/electron-v25.9.8-win32-ia32.zip
wget https://npmmirror.com/mirrors/electron/25.9.8/SHASUMS256.txt

3. 创建完整的项目模板：

项目结构：

my-electron-app/
├── src/
│   ├── index.html
│   ├── index.css
│   ├── index.js
│   └── preload.js
├── electron-offline-packages/
│   ├── electron-25.9.8.tgz
│   ├── electron-forge-cli-6.4.2.tgz
│   ├── electron-v25.9.8-win32-x64.zip
│   └── ...
├── package.json
├── forge.config.js
└── .npmrc

package.json:

{"name": "my-electron-app","version": "1.0.0","description": "My Electron App","main": "src/index.js","scripts": {"start": "electron-forge start","package": "electron-forge package","make": "electron-forge make"},"author": "author","license": "ISC","dependencies": {"electron-squirrel-startup": "^1.0.0"},"devDependencies": {"@electron-forge/cli": "^6.4.2","@electron-forge/maker-deb": "^6.4.2","@electron-forge/maker-rpm": "^6.4.2","@electron-forge/maker-squirrel": "^6.4.2","@electron-forge/maker-zip": "^6.4.2","electron": "25.9.8"}
}

forge.config.js:

module.exports = {packagerConfig: {asar: true,download: {mirror: "https://npmmirror.com/mirrors/electron/",cache: "./electron-cache"}},rebuildConfig: {},makers: [{name: '@electron-forge/maker-squirrel',config: {name: 'my_electron_app'}},{name: '@electron-forge/maker-zip',platforms: ['darwin', 'win32']}]
};

.npmrc:

registry=https://registry.npmmirror.com/
electron_mirror=https://npmmirror.com/mirrors/electron/
electron-custom-dir=25.9.8

4. 打包整个项目：

# 将项目打包为 zip
zip -r electron-project-template.zip my-electron-app

2.离线环境使用

1. 解压项目模板：

unzip electron-project-template.zip
cd my-electron-app

2. 创建 electron 缓存目录：

mkdir -p electron-cache/electron/25.9.8

3. 复制 Electron 二进制文件：

# 将之前下载的 electron 二进制文件复制到缓存目录
cp electron-offline-packages/electron-v25.9.8-win32-x64.zip electron-cache/electron/25.9.8/
cp electron-offline-packages/SHASUMS256.txt electron-cache/electron/25.9.8/

4. 离线安装依赖：

# 安装离线包
npm install ./electron-offline-packages/*.tgz

5. 执行打包：

# 打包应用
npm run make

打包后的输出目录：

out/
├── make/
│   └── squirrel.windows/
│       └── x64/
│           ├── my_electron_app-1.0.0 Setup.exe
│           └── ...
└── my-electron-app-win32-x64/└── my-electron-app.exe

3.网络问题

离线环境 npm run make 时会出现 econnrefuesd ip地址 错误

这个错误是因为在离线环境下还在尝试连接 npm 镜像源。需要完全禁用网络请求：

1. 首先修改 .npmrc 文件：

registry=https://registry.npmmirror.com/  //或者换成本地代理地址http://localhost:4873/
electron_mirror=file:///D:/Electron/my-electron-app/electron-cache/ //换成
electron_custom_dir=25.9.8
offline=true
prefer-offline=true
no-proxy=true
https-proxy=false
proxy=false

2. 修改 forge.config.js：

module.exports = {packagerConfig: {asar: true,download: {mirror: "file:///D:/Electron/my-electron-app/electron-cache/",cache: "./electron-cache",force: false},electronZipDir:'./electron-cache/electron/25.9.8/' // 这行☆☆☆☆☆},makers: [{name: '@electron-forge/maker-squirrel',config: {name: 'my_electron_app'}},{name: '@electron-forge/maker-zip',platforms: ['win32']}],// 添加离线配置 ☆☆☆☆☆electronRebuildConfig: {onlyModules: [],force: false,offline: true}
};

3. 确保电子缓存目录结构正确：

electron-cache/
└── electron/└── 25.9.8/├── electron-v25.9.8-win32-x64.zip├── electron-v25.9.8-win32-ia32.zip (如果需要)└── SHASUMS256.txt

4. 运行打包时使用离线模式：

# Windows
set ELECTRON_ENABLE_OFFLINE_MODE=1
npm run make --offline# Linux/Mac
export ELECTRON_ENABLE_OFFLINE_MODE=1
npm run make --offline