gradle环境变量 gradle_user_home
时间: 2025-01-30 20:58:18 浏览: 45
### 配置和使用 Gradle 环境变量 `GRADLE_USER_HOME`
`GRADLE_USER_HOME` 是一个重要的环境变量,用于定义 Gradle 下载文件以及缓存数据的位置。当执行项目中的 `gradle/wrapper/gradle-wrapper.jar` 文件时,会依据 `project/gradle/gradle-wrapper.properties` 中指定的 Gradle 版本下载并存储到此目录下[^1]。
对于 Linux 或 macOS 用户来说,在终端中可以通过命令来设定这一环境变量:
```bash
export GRADLE_USER_HOME=/path/to/gradle/user/home
```
上述命令仅对当前 shell session 生效;如果希望永久生效,则需将该行添加至用户的 Shell 初始化脚本(如 `.bashrc`, `.zshrc`)中[^2]。
Windows 用户则可以在系统属性 -> 高级系统设置 -> 环境变量里新增名为 `GRADLE_USER_HOME` 的用户或系统变量,并为其赋值为目标路径[^4]。
值得注意的是,在 IntelliJ IDEA 这样的集成开发环境中,“Gradle User Home” 和 `GRADLE_USER_HOME` 存在区别。“Gradle User Home”是指 IDE 自身用来管理 Gradle 安装及其依赖项的一个特定位置,而后者则是由操作系统级别的环境变量控制,影响全局范围内的 Gradle 行为[^3]。
为了确保配置无误,可以尝试创建一个新的 Gradle 项目并通过命令行运行构建任务,观察日志输出确认使用的 Gradle 是否来自预期的位置。另外也可以查看本地磁盘上是否存在按照所设路径建立的新文件夹结构作为间接证据。
阅读全文
相关推荐

















