Electron打包MacOS应用时如何内置.env并正确加载环境变量

打包后.env失效本质是两个默认规则不匹配：

• electron-builder 默认不会把项目根目录下未被代码引用的.env文件纳入打包清单，文件不会出现在最终安装包内
• dotenv.config() 默认读取进程当前工作目录下的.env文件，打包后应用的运行时工作目录、资源存放路径和开发环境完全不同，默认路径匹配逻辑失效

1. 配置打包规则，强制内置.env文件 #

在electron-builder配置中添加extraResources字段，明确要求把.env文件打包进应用资源目录。配置可以写在package.json的build节点，也可以写在独立的electron-builder.json/yml配置文件中：

{
  "build": {
    "extraResources": [
      {
        "from": ".env",
        "to": ".env"
      }
    ]
  }
}

配置生效后，.env文件会被原封不动放到安装包的资源目录，MacOS环境下对应路径为应用包内的Contents/Resources/.env。

2. 区分环境动态加载.env路径 #

不要直接调用无参数的dotenv.config()，需要根据运行环境拼接.env的绝对路径后再加载，修改主进程代码如下：

const { app } = require('electron');
const path = require('path');
const dotenv = require('dotenv');

// 按运行环境拼接.env绝对路径
const envFilePath = app.isPackaged
  ? path.join(process.resourcesPath, '.env') // 打包后从应用资源目录读取
  : path.join(app.getAppPath(), '.env'); // 开发环境从项目根目录读取

// 加载配置，增加错误捕获避免文件缺失导致应用直接崩溃
const loadEnvResult = dotenv.config({ path: envFilePath });
if (loadEnvResult.error) {
  throw loadEnvResult.error;
}

// 启动Java子进程逻辑，路径统一用path模块拼接避免跨环境路径错误
const serverScriptPath = path.join(__dirname, 'server/bin/embedded');
this.serverProcess = require("child_process").spawn(
  "/usr/bin/env",
  ["sh", serverScriptPath],
  { env: process.env }
);

注意事项 #

• 如果.env中存储密钥、数据库连接串等敏感信息，不要使用明文内置方案：打包后的.env文件可以被用户直接从安装包中提取查看，这类场景建议在构建阶段通过构建插件将环境变量直接注入代码，或对配置内容做对称加密后再打包
• 如果需要区分测试/生产等多套环境配置，可以在构建命令中传入环境标识，动态修改extraResources的源文件路径即可，不需要改动主进程加载逻辑

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