一、为何需要自定义Android Studio缓存路径？

Android Studio默认将缓存文件（如构建缓存、索引、临时文件）存储在系统盘的用户目录下（如~/.android或~/.gradle）。随着项目规模扩大，这些缓存可能占用数十GB空间，导致系统盘空间告急。此外，若项目存储在机械硬盘（HDD）而系统盘为固态硬盘（SSD），频繁的缓存读写可能引发I/O性能瓶颈。

典型场景：

多项目开发时，不同项目的缓存混杂在默认路径，难以管理。
CI/CD环境需要统一缓存路径以实现增量构建优化。
开发机磁盘空间有限，需将缓存迁移至大容量磁盘。

二、自定义缓存路径的核心方法

1. 通过Gradle配置全局缓存路径

Gradle的gradle.properties文件支持全局配置，可统一修改所有项目的构建缓存路径。

步骤：

在用户目录或项目根目录创建gradle.properties文件。
添加以下配置：
```properties

设置Gradle全局缓存路径（默认在~/.gradle）

gradle.user.home=/path/to/custom/gradle_cache

设置Android构建缓存路径（默认在~/.android/build-cache）

android.buildCacheDir=/path/to/custom/android_build_cache

3. 重启Android Studio使配置生效。
**注意事项**：
- 路径需使用绝对路径，避免相对路径导致的解析错误。
- 多用户环境下，建议为每个开发者配置独立路径，防止权限冲突。
## 2. 通过环境变量动态指定路径
对于需要动态调整的场景（如CI/CD流水线），可通过环境变量覆盖默认路径。
**关键变量**：
- `GRADLE_USER_HOME`：覆盖Gradle全局缓存路径。
- `ANDROID_SDK_HOME`：修改Android SDK相关文件（如AVD模拟器）的存储位置。
- `ANDROID_EMULATOR_HOME`：单独指定模拟器镜像的存储路径。
**示例（Linux/macOS）**：
```bash
export GRADLE_USER_HOME=/mnt/ssd/gradle_cache
export ANDROID_SDK_HOME=/mnt/ssd/android_sdk

Windows配置：

右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
新建系统变量或用户变量，填写变量名和路径值。

3. 项目级缓存路径配置

若需为特定项目定制缓存路径，可在项目的gradle.properties中覆盖全局设置：

# 项目级Gradle缓存路径（仅对当前项目生效）
org.gradle.caching=true
org.gradle.cache.directory=/path/to/project_cache

适用场景：

团队共享项目时，避免个人缓存路径冲突。
针对大型项目单独优化缓存策略。

4. JVM启动参数调整

Android Studio的启动配置（如studio.vmoptions文件）可指定临时文件路径：

# 修改IDE临时目录（默认在系统临时文件夹）
-Djava.io.tmpdir=/path/to/custom/tmp

此配置适用于解决IDE自身产生的临时文件存储问题。

三、多模块项目的缓存管理策略

对于包含多个模块的大型项目，建议采用分层缓存策略：

全局缓存：存储Gradle依赖和公共构建脚本（通过gradle.user.home配置）。
项目级缓存：存储模块特定的构建输出（通过android.buildCacheDir配置）。

模块级缓存：在模块的build.gradle中启用增量编译：

android {
 buildTypes {
     debug {
         // 启用模块级构建缓存
         buildCache {
             enabled true
             local {
                 directory file("/path/to/module_cache/${project.name}")
             }
         }
     }
 }
}

优势：

减少重复编译，提升多模块项目构建速度。
避免不同模块的缓存相互覆盖。

四、CI/CD环境下的最佳实践

在持续集成环境中，缓存路径的配置需兼顾性能与可维护性：

持久化缓存目录：将缓存路径挂载至持久化存储卷（如云存储或NFS）。
版本化缓存：为不同分支或版本创建独立缓存目录，避免污染。

清理策略：定期清理过期缓存，防止磁盘爆满：

# 清理超过30天的Gradle缓存
find /path/to/gradle_cache -type d -mtime +30 -exec rm -rf {} \;

示例配置（Jenkinsfile）：

pipeline {
    agent any
    environment {
        GRADLE_USER_HOME = "${env.WORKSPACE}/.gradle_cache"
        ANDROID_BUILD_CACHE = "${env.WORKSPACE}/.android_build_cache"
    }
    stages {
        stage('Build') {
            steps {
                sh './gradlew assembleDebug --stacktrace'
            }
        }
    }
    post {
        always {
            // 保留最近5次构建的缓存
            sh 'find .gradle_cache -type d -name "caches*" -mtime +5 -exec rm -rf {} \;'
        }
    }
}

五、性能优化与问题排查

1. 缓存路径选址原则

SSD优先：将高频读写的缓存（如Gradle依赖库）放在SSD。
独立分区：避免缓存路径与系统日志、虚拟内存共用磁盘。
网络存储慎用：NFS/SMB等网络存储可能因延迟导致构建变慢。

2. 常见问题解决

问题1：修改路径后构建失败，提示“Permission denied”。
解决：确保目标路径对当前用户有读写权限，可通过chmod调整。

问题2：缓存未生效，仍使用默认路径。
解决：

检查是否在正确的gradle.properties文件中配置（用户级优先于项目级）。
验证环境变量是否生效（通过echo $GRADLE_USER_HOME检查）。

问题3：多用户环境下缓存冲突。
解决：为每个用户配置独立的GRADLE_USER_HOME，或使用符号链接指向用户专属目录。

六、总结与建议

优先全局配置：通过gradle.properties或环境变量统一管理路径，减少维护成本。
监控缓存增长：定期使用du -sh命令检查缓存目录大小，及时清理无用文件。
结合版本控制：将缓存路径配置纳入项目文档，确保团队成员一致。
测试性能影响：修改路径后，通过./gradlew --profile build对比构建时间变化。

通过合理自定义Android Studio的缓存路径，开发者可显著提升构建效率、优化磁盘空间利用，并适应多样化的开发环境需求。

Android Studio缓存路径优化：自定义配置与性能提升指南