distributionBase控制Gradle Wrapper发行包缓存根目录，与distributionPath共同决定实际路径，默认为$GRADLE_USER_HOME/wrapper/dists；改distributionBase=PROJECT会污染项目目录，推荐改环境变量GRADLE_USER_HOME指向新路径。
gradle-wrapper.properties 里的 distributionBase 控制缓存位置
Gradle Wrapper 解压后的发行包（比如 gradle-8.7-bin.zip）默认存在 ~/.gradle/wrapper/dists，但这个路径不是硬编码的，而是由 gradle-wrapper.properties 中的 distributionBase 和 distributionPath 共同决定。
关键点在于：distributionBase=GRADLE_USER_HOME 表示“以 GRADLE_USER_HOME 为根”，distributionPath=wrapper/dists 是相对路径。所以最终目录 = $GRADLE_USER_HOME/wrapper/dists。
- 如果没设
GRADLE_USER_HOME，它默认指向~/.gradle（Windows 是C:\Users\{user}\.gradle） - 想彻底换地方？直接改
distributionBase=PROJECT，那发行包就会解压到项目根目录下的gradle/wrapper/dists—— 但不推荐，会污染项目目录 - 更稳妥的做法：保持
distributionBase=GRADLE_USER_HOME，只改环境变量GRADLE_USER_HOME指向新路径（如D:\gradle\home），所有项目的 Wrapper 发行包都会落到D:\gradle\home\wrapper\dists
为什么只改 gradle.properties 里的 org.gradle.caching.path 不起作用
org.gradle.caching.path 控制的是构建缓存（build cache），不是 Wrapper 发行包缓存 —— 这是两个完全不同的东西。前者存 build-cache 目录里的任务输出，后者存 wrapper/dists 里的解压后 Gradle 运行时。
常见错误现象：gradle.properties 里加了 org.gradle.caching.path=/D:/gradle/cache，结果 .gradle/wrapper/dists 还是在 C 盘，新建项目依然卡在下载 gradle-8.7-bin.zip。
- Wrapper 发行包路径只认
gradle-wrapper.properties+GRADLE_USER_HOME，跟gradle.properties无关 -
org.gradle.caching.path是给--build-cache用的，和./gradlew找不到 Gradle 二进制完全不搭界 - 混淆这两者，是本地调试时最常白忙活一小时的原因
手动放好发行包后，为什么 ./gradlew 还是去下载
Gradle Wrapper 有严格校验逻辑：它不会直接运行你随便丢进去的文件夹，而是按 distributionUrl 计算出一个哈希子目录名（比如 gradle-8.7-bin/7a6x5v9y1qz2b3c4d5e6f7g8h9i0j1k），然后检查该子目录下是否存在完整解压内容 + 正确的 gradle-wrapper.jar 校验文件。
如果你只是把 gradle-8.7-bin.zip 放进 ~/.gradle/wrapper/dists，但没解压、没生成对应哈希目录，或者解压后少了 gradle/wrapper/gradle-wrapper.jar，它就判定“缺失”，强制重下。
- 正确做法：先用
./gradlew --version触发一次失败下载，让它生成目标哈希目录（空的）；再把 zip 放进去，手动解压到该目录；最后确认里面有bin/gradle和lib/gradle-launcher-8.7.jar - 更省事：用
gradle wrapper --gradle-version 8.7 --distribution-type bin生成一次标准结构，再替换 zip 文件 - 别忘了校验
distributionSha256Sum（如果配置了），否则即使文件对，也会因校验失败而重下
Windows 下 file:/// 路径容易写错的三个细节
把 distributionUrl 改成本地路径（file:///）是离线构建的关键，但 Windows 用户常在这里翻车：
- 必须用正斜杠
/，哪怕你在资源管理器里看到的是反斜杠\—— 写成file:///D:\gradle\gradle-8.7-bin.zip会直接报Malformed URL - 开头三个
/缺一不可：file:///D:/gradle/gradle-8.7-bin.zip✔️，file://D:/...❌（少一个/） - 路径要绝对且可读：确保当前用户对
D:/gradle/有读权限，IDEA/AS 启动时若以管理员身份运行，可能读不到普通用户目录下的文件
真正生效的路径，得同时满足 GRADLE_USER_HOME 指向合理位置、distributionUrl 格式无误、目标 zip 存在且可访问 —— 少一个环节，./gradlew build 就会默默连外网。
