Mac下NetBeans 15读取系统环境变量失败（Gradle构建）原因及解决方案

我近期开始用GitHub Packages分发内部共享库，于是修改了Gradle构建配置，用系统环境变量替换硬编码的凭证，配置示例如下：

repositories {

    mavenLocal() // only use when testing -SNAPSHOT locally

    mavenCentral() // third-parties
    
    maven { // our-library
          name = "MyLibrary"
          url = "https://maven.pkg.github.com/MyCompany/mylibrary"
          credentials {
                    username = project.findProperty("git_username") ?: System.getenv("git_username")
                    password = project.findProperty("git_token") ?: System.getenv("git_token")
          }
    }
}

但不管我修改~/.zshrc、.zshenv、.bash_profile还是/etc/launchd.conf，执行source命令或重启后，终端里用echo $git_username或printenv都能正常看到环境变量，可从Dock启动NetBeans 15时，Gradle构建始终提示凭证无效（实际解析为null）。

我测试过在~/.zshrc里添加别名，从终端启动NetBeans就能解决问题，但这样就没法用Dock图标了，配置内容如下：

#
# RW - For GitHub Package access
#
export git_username=NotApplicableUsesToken
export git_token=redacted1
export git_publish_username=NotApplicableUsesToken
export git_publish_token=redacted2

#
# RW - So Netbeans launches and honours the environment variables above
#
alias netbeans="/Applications/NetBeans/Apache\ NetBeans\ 15.app/Contents/MacOS/netbeans &"

我的疑问：

• 为什么从Dock启动NetBeans无法识别环境变量？
• 怎么配置才能不用这个临时方案，让NetBeans正常读取环境变量？

一、Dock启动无法读取环境变量的原因 #

在macOS中，从Dock启动的App属于图形化会话，它的环境变量继承自launchd，而非终端的Shell配置文件（比如.zshrc、.bash_profile）。终端里的Shell配置文件仅在启动交互式Shell时加载，图形化App不会触发这个流程。

你之前修改的/etc/launchd.conf在新版macOS（如Big Sur及以后）已不再生效，所以添加的环境变量不会被图形化会话读取。而从终端启动NetBeans时，App会继承终端Shell的环境变量，因此能正常获取到git_username和git_token。

二、无需临时方案的解决方法 #

方法1：通过launchctl设置全局环境变量（推荐） #

要让图形化App读取到环境变量，需通过launchctl将变量加载到用户的launchd会话中：

1. 创建~/Library/LaunchAgents/environment.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>user.environment</string>
  <key>ProgramArguments</key>
  <array>
    <string>sh</string>
    <string>-c</string>
    <string>launchctl setenv git_username NotApplicableUsesToken; launchctl setenv git_token redacted1; launchctl setenv git_publish_username NotApplicableUsesToken; launchctl setenv git_publish_token redacted2</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
</dict>
</plist>

2. 加载这个plist文件：

launchctl load ~/Library/LaunchAgents/environment.plist

3. 重启Mac，之后从Dock启动NetBeans就能读取到这些环境变量。

方法2：修改NetBeans的启动配置 #

直接给NetBeans的启动脚本添加环境变量：

1. 进入NetBeans安装目录下的配置文件夹：/Applications/NetBeans/Apache NetBeans 15.app/Contents/Resources/NetBeans/netbeans/etc
2. 编辑netbeans.conf文件，找到netbeans_default_options行，在末尾添加环境变量配置：

netbeans_default_options="... --J-Dgit_username=NotApplicableUsesToken --J-Dgit_token=redacted1 --J-Dgit_publish_username=NotApplicableUsesToken --J-Dgit_publish_token=redacted2"

3. 保存文件后重启NetBeans，Gradle可通过System.getProperty()读取这些变量（原Gradle配置无需修改，因为project.findProperty()会优先读取系统属性）。

方法3：使用Gradle的gradle.properties文件 #

放弃系统环境变量，直接在用户目录的~/.gradle/gradle.properties中添加凭证：

git_username=NotApplicableUsesToken
git_token=redacted1
git_publish_username=NotApplicableUsesToken
git_publish_token=redacted2

Gradle会自动读取该文件的属性，无论NetBeans从哪里启动都能生效，且更安全（避免环境变量被其他App读取）。

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