Java 在 Gradle 构建时环境变量怎么配置-java教程-PHP中文网

java项目gradle构建需配置三类环境变量：必须设jdk和gradle_home以确保运行基础；推荐设gradle_user_home优化缓存位置；行为控制参数应写入gradle.properties而非系统变量。

java 在 gradle 构建时环境变量怎么配置

Java 项目用 Gradle 构建时，环境变量配置主要围绕三类关键变量：JDK 运行环境、Gradle 自身路径、以及 Gradle 的缓存与行为控制。不是所有变量都必须手动设，但设对能避免版本冲突、加速构建、统一团队行为。

必须配置的 JDK 和 GRADLE_HOME

Gradle 是 Java 应用，依赖 JDK 启动；它自身也需要被系统识别为命令。这两项是基础门槛：

JDK 已安装且 java -version 可见：推荐 JDK 17+（Gradle 8.5+ 官方兼容），不建议仅靠 JRE；若命令报错，先检查 JAVA_HOME 是否设置、Path 是否含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）
GRADLE_HOME 指向解压根目录：例如 C:\gradle\gradle-8.8 或 /opt/gradle/gradle-8.8；不能指向 bin 子目录
Path 中添加 %GRADLE_HOME%\bin（Windows）或 $GRADLE_HOME/bin（macOS/Linux）：这样终端任意位置才能运行 gradle -v

推荐配置的 GRADLE_USER_HOME

这个变量决定 Gradle 缓存（依赖 jar、插件、构建输出等）存放位置，默认在 C:\Users\{user}\.gradle 或 ~/.gradle。建议显式指定：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

避免 C 盘快速占满（尤其 Windows 用户）
便于多项目共享缓存，或与 Maven 本地仓库复用（比如设为 D:\m2\repository）
Windows 下新建系统变量 GRADLE_USER_HOME，值为自定义路径（如 D:\.gradle）；macOS/Linux 在 ~/.zshrc 加 export GRADLE_USER_HOME=/data/.gradle

影响构建行为的常用属性变量

这些不通过系统环境变量直接设，而是写进 gradle.properties 文件，更可靠、可提交到 Git：

org.gradle.jvmargs：调大 JVM 堆内存，防止 OOM，例如 org.gradle.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=512m
org.gradle.caching=true：开启构建缓存，显著提速重复构建
org.gradle.configuration-cache=true：启用配置缓存（Gradle 6.6+），加快构建初始化
systemProp.http.proxyHost / systemProp.https.proxyPort：内网环境需配代理
文件位置优先级：项目根目录 gradle.properties > 用户主目录 $GRADLE_USER_HOME/gradle.properties > Gradle 安装目录 $GRADLE_HOME/gradle.properties

镜像源配置（非环境变量，但常被误认为是）

仓库地址不通过环境变量控制，而是写在构建脚本里：

全局生效：在 $GRADLE_USER_HOME/init.d/ 下新建 aliyun-init.gradle，内容包含 allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public' } } }
单项目生效：在项目 build.gradle 的 repositories 块中添加阿里云或腾讯云镜像
注意不要和 Maven 的 settings.xml 混淆——Gradle 不读该文件

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南