临时指定GRADLE_USER_HOME的三种可靠方式是：1.用-Dgradle.user.home启动参数（推荐），2.通过环境变量GRADLE_USER_HOME临时覆盖，3.避免使用gradle.properties文件以免污染配置；均只对当前构建生效，不修改全局环境。
临时指定 GRADLE_USER_HOME 的三种可靠方式
不需要改配置、不污染全局环境，只对当前构建生效——这是调试、CI 临时切换缓存位置或规避磁盘空间不足最常用的做法。核心就一条：让 Gradle 启动时读到 GRADLE_USER_HOME 这个系统属性。
用 -Dgradle.user.home 启动参数（推荐）
这是最直接、最可控的临时方式，适用于命令行、CI 脚本、IDE 终端等所有能传参的场景。Gradle JVM 启动时会识别该系统属性，并覆盖默认路径。
-
gradle build -Dgradle.user.home=/tmp/gradle-test—— 注意：必须放在build等任务名之后，否则会被当作任务参数忽略 - 如果要同时设置 JVM 参数（如内存），需用
GRADLE_OPTS：GRADLE_OPTS="-Xmx2g -Dgradle.user.home=/tmp/gradle-test" gradle build - 这个方式不会影响
gradle.properties文件里的其他配置，也不会触发 IDE 的自动重载逻辑
通过环境变量 GRADLE_USER_HOME 临时覆盖
比修改系统环境变量更轻量，只在当前 shell 会话中生效，适合脚本封装或快速验证。
- Linux/macOS：
GRADLE_USER_HOME=/tmp/gradle-test gradle build - Windows CMD：
set GRADLE_USER_HOME=D:\temp\gradle-test && gradle build - PowerShell：
$env:GRADLE_USER_HOME="D:\temp\gradle-test"; gradle build - 注意：Windows 下
set命令只对当前命令行有效，不能跨行；PowerShell 需用$env:语法
为什么不用 gradle.properties 临时改？
虽然在项目根目录放一个 gradle.properties 并写入 gradle.user.home=/path 也能生效，但它有明显副作用：
- 该文件会被 Git 跟踪（除非你手动加 .gitignore），容易误提交，污染团队配置
- 它会影响所有子项目，包括你可能没意识到的
init.d或settings.gradle加载逻辑 - IDE（如 IntelliJ、Android Studio）通常会主动读取并缓存这个值，改完后可能需要重启 IDE 才刷新
- 它本质上不是“临时”的，而是项目级持久配置，和“只跑这一次”的需求错位
真正临时的动作，应该只发生在进程启动那一刻。参数和环境变量都满足这点；而文件写入是状态残留，容易被遗忘、误传播——尤其在共享开发机或 CI 容器里，这点特别关键。
