如何修改Gradle Wrapper生成的项目根目录下.gradle文件夹位置？

问题背景 #

首次执行Gradle Wrapper（gradlew）时，会在执行命令的目录（即项目根目录）生成.gradle文件夹，用于存放Wrapper下载的Gradle分发包。设置GRADLE_USER_HOME仅能控制全局缓存路径，无法改变这个项目级.gradle文件夹的位置，导致GitHub CI模板因缓存路径不匹配（期望缓存backend/.gradle，实际生成在根目录）触发警告。

解决方案 #

修改Gradle Wrapper的配置文件，指定分发包的存储路径到backend/.gradle目录下：

1. 打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件
2. 在现有配置（比如distributionUrl）下方添加以下两行配置：

   distributionBase=PROJECT
   distributionPath=backend/.gradle/wrapper/dists
   

配置说明 #

• distributionBase=PROJECT：表示分发包的存储基准路径为项目根目录
• distributionPath=backend/.gradle/wrapper/dists：指定在基准路径下的具体存储位置，最终Gradle分发包会被下载到ROOT/backend/.gradle/wrapper/dists目录，同时backend/.gradle文件夹会被自动创建，正好匹配CI模板的缓存路径。

验证 #

修改完成后，重新执行gradlew命令，检查backend/.gradle是否生成，根目录下的.gradle文件夹不会再被创建（已生成的可手动删除）。此时CI缓存$CI_PROJECT_DIR/$CONF_WORK_DIRECTORY/.gradle就能找到对应文件，消除警告。

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