使用Babel构建Electron Windows可执行程序报import语法错误

本地开发可正常运行，是因为启动命令携带了-r @babel/register参数，运行阶段会实时将ES Module语法的代码转译为CommonJS格式供Node.js执行。
electron-builder打包时直接将未经过babel编译的原始index.js（包含import ESM语法）打入安装包，打包后的程序运行时不会自动加载@babel/register执行实时转译，Node.js默认将.js文件识别为CommonJS模块，遇到import关键字直接抛出语法错误。

• 检查electron-builder的files配置项：当前配置直接打包根目录下的原始index.js源文件，整个打包流程没有配置babel预编译步骤，打入产物的代码保留了原始ESM语法
• 检查入口配置：package.json的main字段指向未编译的源文件index.js，而非babel编译后的产物路径
• 检查打包脚本：当前build-package脚本仅执行打包命令，没有前置的源码编译动作

二选一即可，优先选择方案1。

方案1：预编译源码后打包（推荐） #

该方案不需要将babel依赖打入生产包，安装包体积更小，程序启动速度更快。

1. 修改package.json的scripts字段，新增babel编译脚本，调整打包脚本为先编译再打包：

"scripts": {
  "manual-run": "electron --trace-warnings -r @babel/register .",
  "build-babel": "babel . --ignore node_modules,distout,build --out-dir dist",
  "build-package": "npm run build-babel && electron-builder --windows nsis:ia32"
}

2. 调整入口和打包配置：
   • 将package.json的main字段修改为"main": "dist/index.js"，指向编译后的产物
   • 修改build.files配置，移除原始源文件的打包规则，仅保留编译产物和必要配置：

"files": [
  "dist/**/*",
  "package.json"
]

3. 依赖清理：将dependencies下所有@babel/*开头的依赖全部移到devDependencies中，编译后的代码运行不需要这些依赖，可进一步缩小包体积。

方案2：保留运行时实时转译（不推荐） #

该方案不需要调整编译流程，但会把所有babel依赖打入生产包，安装包体积大、启动速度慢。

1. 新建入口文件entry.js作为打包后的程序入口，内容如下：

require('@babel/register');
require('./index.js');

2. 将package.json的main字段修改为"main": "entry.js"
3. 调整build.files配置，将entry.js、所有源码文件、.babelrc配置文件加入打包列表，保证生产环境运行时@babel/register和相关preset可被正常加载。

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