为什么双击启动macOS应用时无法读取zsh设置的环境变量？

根因说明 #

双击启动的GUI应用由系统launchd进程直接拉起，全程不会加载任何shell的配置文件（包括你编写的~/.zshenv），因此shell配置里定义的环境变量对这类启动方式的应用完全不生效。

解决方案 #

方案1：临时全局生效（重启后失效） #

直接在终端执行以下命令，执行后新启动的所有GUI应用都可读取到该变量，系统重启后配置会自动失效：

launchctl setenv VARNAME VARVALUE

将VARNAME和VARVALUE替换为实际的变量名和值即可。

方案2：永久全局生效（用户登录后自动生效） #

1. 新建plist配置文件~/Library/LaunchAgents/local.customenv.plist，写入以下内容：

<?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>local.customenv</string>
    <key>ProgramArguments</key>
    <array>
        <string>launchctl</string>
        <string>setenv</string>
        <string>VARNAME</string>
        <string>VARVALUE</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <false/>
</dict>
</plist>

如果需要配置多个环境变量，在ProgramArguments数组中新增对应launchctl setenv的条目即可。
2. 执行命令加载配置，即刻生效，后续系统重启也会自动加载该配置：

launchctl load ~/Library/LaunchAgents/local.customenv.plist

方案3：仅针对单个应用生效（不影响全局环境） #

两种实现方式可选：

方式A：通过defaults命令配置

先执行命令获取目标应用的Bundle ID：

osascript -e 'id of app "/Applications/myApp.app"'

将返回的ID替换到下面命令的对应位置执行即可：

defaults write 你的应用BundleID LSEnvironment -dict-add VARNAME VARVALUE

方式B：自定义启动脚本

编写zsh启动脚本，内容如下：

#!/bin/zsh
export VARNAME=VARVALUE
open /Applications/myApp.app

给脚本添加执行权限：chmod +x 你的脚本路径，之后可以直接双击脚本启动应用，也可以用macOS自带的「脚本编辑器」把脚本导出为.app格式，放在应用程序文件夹中使用。

注意事项 #

所有配置修改完成后，需要完全退出目标应用（右键程序坞图标→退出，确认后台没有驻留）再重新打开，变量才会生效。

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