如何向IntelliJ IDEA管理的Gradle构建文件传递自定义环境变量

根本原因 #

macOS 中通过 Dock、Launchpad 启动的 GUI 应用默认不会加载 bash/zsh 的用户配置文件，因此你在 .bash_profile、.zshrc 中配置的环境变量不会被 IDEA 继承，导致 Gradle 加载时读取不到凭证。

解决方案 #

方案1：直接在IDEA Gradle配置中添加环境变量（最推荐，临时凭证更新方便） #

操作步骤：

• 打开IDEA偏好设置（快捷键 ⌘,），依次进入 Build, Execution, Deployment → Build Tools → Gradle
• 找到「Environment variables」配置项，点击右侧的编辑图标
• 在弹出的窗口中添加键值对 CODEARTIFACT_AUTH_TOKEN=你的最新临时凭证
• 保存配置后重新加载Gradle项目即可生效

方案2：从终端启动IDEA，继承终端环境变量 #

如果平时习惯用终端打开项目，直接在项目目录下执行 idea . 启动IDEA，此时IDEA会完全继承终端的所有环境变量，无需额外修改配置就能读取到你在shell配置文件中设置的凭证。

方案3：配置全局Gradle属性，适配所有运行场景 #

在用户目录下的 .gradle/gradle.properties 文件中添加配置（如果文件不存在可以手动创建）：

codeartifactAuthToken=你的最新临时凭证

修改项目中build.gradle的凭证读取逻辑，兼容属性和环境变量两种读取方式：

repositories {
  maven {
    url 'https://***.codeartifact.***.amazonaws.com/maven/***'
      credentials {
        username "***"
        password project.findProperty('codeartifactAuthToken') ?: System.getenv('CODEARTIFACT_AUTH_TOKEN')
    }
  }
}

该方案的优势是配置一次后，终端运行Gradle和IDEA加载Gradle都可以正常读取凭证，无需区分运行环境。

方案4：设置全局launchd环境变量（适配所有GUI应用） #

如果需要所有GUI应用都能读取到该环境变量，可以在终端执行命令设置launchd全局变量：

sudo launchctl setenv CODEARTIFACT_AUTH_TOKEN 你的最新临时凭证

执行完成后重启IDEA即可生效。注意该配置会在系统重启后失效，如果需要开机自动生效，可以将该命令写入plist文件放在~/Library/LaunchAgents/目录下配置为开机启动项。

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