Electron麒麟系统&Windows系统套壳搭建部署

本文档针对麒麟 ARM、Windows32 位、Windows64 位三套部署系统，制定了配套的 Electron 与 electron-builder 固定兼容版本、标准化安装流程与校验规范，完整解决跨平台打包依赖下载慢、版本不匹配、打包启动报错等问题，核心要点如下：

一、环境前置清理（必做，所有系统通用）

为避免旧版本依赖、缓存冲突导致安装失败、项目启动报错、打包异常，部署前必须彻底清理旧环境。

1.1 删除旧 Electron 项目依赖文件

终端执行 PowerShell 命令，强制清空旧依赖：

Remove-Item -Path node_modules, package-lock.json -Recurse -Force

作用：删除项目旧依赖目录与版本锁定文件，彻底清除残留旧版本依赖。

1.2 清理 NPM 全局缓存

npm cache clean --force

作用：清除本地缓存包，防止缓存劫持导致版本安装错误。

所有安装、配置、打包均严格遵循下表，不可随意混用版本，是项目部署成功的核心依据。

3.1 麒麟系统安装命令

步骤1：安装兼容版打包工具

npm install electron-builder@23.6.0 --save-dev

步骤2：镜像加速安装 Electron 核心依赖

npx cross-env ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm install electron@18.2.3 --save-dev

3.2 Windows 32位系统安装命令

步骤1：安装兼容版打包工具（Electron14 专属）

npm install electron-builder@23.6.0 --save-dev

步骤2：镜像加速安装 Electron 核心依赖

npx cross-env ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm install electron@14.2.9 --save-dev

3.3 Windows 64位系统安装命令

步骤1：安装高版本打包工具

npm install electron-builder@24.13.3 --save-dev

步骤2：镜像加速安装 Electron 核心依赖

npx cross-env ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm install electron@22.3.27 --save-dev

安装完成后必须验证版本，确认与对照表一致，否则项目无法运行打包。

验证异常排查：若版本不对，重新执行环境清理命令后重装，大概率是缓存未清理导致。

安装对应版本后，必须同步修改 package.json 和 main.js，版本与配置必须一一对应，否则会出现启动报错、功能异常。

5.1 package.json devDependencies 配置

麒麟系统 / Windows32位统一配置：

5.2 main.js 适配优化说明

不同 Electron 版本 API 存在差异，需根据当前安装版本适配修改：

该配置支持 Windows32/64 位双架构打包，同时生成 NSIS 安装包和 ZIP 绿色压缩包，可按需删减架构。

配置说明：默认优先打包64位版本，适配绝大多数Windows设备，如需纯32位低端设备，删除x64即可。