Electron打包分发版如何读取环境变量？（macOS Monterey）

问题原因 #

用npm start在终端运行Electron时，应用会继承终端shell的环境变量（比如从.zshrc/.bash_profile加载的JAVA_HOME）；但打包后的.app从Finder/Launchpad等GUI入口启动时，macOS不会为GUI应用加载用户shell的配置文件，导致process.env.JAVA_HOME返回undefined。

解决方案 #

1. 配置macOS全局GUI环境变量 #

这是最通用的方法，让所有GUI应用都能读取到目标环境变量：

• 新建或编辑~/Library/LaunchAgents/environment.plist文件，写入以下内容（替换成你的JAVA_HOME路径）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>custom.environment</string>
  <key>ProgramArguments</key>
  <array>
    <string>sh</string>
    <string>-c</string>
    <string>launchctl setenv JAVA_HOME /Library/Java/JavaVirtualMachines/你的JDK版本.jdk/Contents/Home</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
</dict>
</plist>

• 执行命令加载配置：

launchctl load ~/Library/LaunchAgents/environment.plist

• 重启电脑后，Electron分发版就能通过process.env.JAVA_HOME读取到环境变量。

2. 在Electron应用中主动读取shell配置文件 #

如果需要适配不同用户的shell配置，可以在主进程中读取用户的shell配置文件并解析环境变量：

const fs = require('fs');
const path = require('path');

function resolveJavaHome() {
  // 根据用户使用的shell选择配置文件（zsh/bash/fish等）
  const shellConfigPath = path.join(process.env.HOME, '.zshrc');
  try {
    const configContent = fs.readFileSync(shellConfigPath, 'utf8');
    // 匹配export JAVA_HOME=xxx的行
    const javaHomeMatch = configContent.match(/^\s*export\s+JAVA_HOME=(.*)$/m);
    if (javaHomeMatch) {
      // 去掉可能的引号并返回
      return javaHomeMatch[1].replace(/["']/g, '').trim();
    }
  } catch (error) {
    console.warn('读取shell配置文件失败:', error.message);
  }
  // 兜底返回系统环境变量
  return process.env.JAVA_HOME;
}

// 使用示例
const javaHome = resolveJavaHome();
console.log('JAVA_HOME:', javaHome);

注意：需要根据用户实际使用的shell调整读取的配置文件（比如bash用.bashrc，fish用~/.config/fish/config.fish）。

3. 打包时嵌入固定环境变量（仅适用于路径固定场景） #

如果你的应用只针对特定环境，且JAVA_HOME路径固定，可以在打包时将变量注入到应用中：
修改package.json的scripts：

"scripts": {
  "start": "electron .",
  "pack": "electron-builder --dir",
  "dist": "JAVA_HOME=/固定的JDK路径 electron-builder"
}

这种方法的局限性是打包时的路径是开发者机器上的，用户机器路径不同会失效，仅适合特定场景。

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