如何将Android Studio项目中的.gradle文件夹迁移至其他位置？

方法1：全局配置指定Gradle用户目录 #

通过设置GRADLE_USER_HOME环境变量，将Gradle的全局缓存、配置目录统一移到项目结构之外：

• 临时生效（仅当前终端会话）：

  # Linux/macOS
  export GRADLE_USER_HOME=/path/to/your/external/folder/.gradle
  # Windows 命令提示符
  set GRADLE_USER_HOME=C:\path\to\your\external\folder\.gradle
  # Windows PowerShell
  $env:GRADLE_USER_HOME = "C:\path\to\your\external\folder\.gradle"
  

• 永久生效：
  • Linux/macOS：编辑~/.bashrc或~/.zshrc，添加上述export命令后重启终端
  • Windows：在系统环境变量中新增GRADLE_USER_HOME变量，值设为目标外部路径

方法2：项目级配置指定构建目录 #

如果仅需针对当前项目修改构建生成的.gradle目录位置，可在项目根目录的settings.gradle（或settings.gradle.kts）中添加配置：

Groovy 语法（settings.gradle） #

rootProject.buildDir = "/path/to/external/folder/build"

Kotlin 语法（settings.gradle.kts） #

rootProject.buildDir = File("/path/to/external/folder/build")

配置后，项目构建产生的临时文件会全部放到指定的外部目录，不会在项目内重新生成.gradle目录。

注意事项 #

• 确保目标外部目录具备读写权限，否则会触发Gradle构建失败
• 配置完成后，删除原项目内的.gradle目录，避免残留文件干扰同步逻辑

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