出现“could not install gradle distribution”报错，本质是android studio无法从https://services.gradle.org/distributions/下载指定版本gradle压缩包，主因是网络不稳定或访问受限，而非代码或依赖问题。
看错误日志里有没有 Could not install Gradle distribution
出现这行，基本可以确定是 Gradle 发行版下载失败，不是项目代码或依赖的问题。Android Studio 尝试从 https://services.gradle.org/distributions/ 拉取 gradle-x.x.x-bin.zip，但卡住、超时或被重置连接。
这时候别急着改配置，先确认两点：
- 打开
gradle/wrapper/gradle-wrapper.properties，看distributionUrl的值是不是以https开头； - 复制这个 URL 到浏览器访问，看能否直接下载（注意：要带完整路径，比如
gradle-8.4-bin.zip）； - 如果浏览器也打不开或下载极慢，说明是网络问题，不是你配错了。
检查 gradle-wrapper.properties 和 build.gradle 版本是否对得上
Gradle Wrapper 版本和 Android Gradle Plugin（AGP）版本必须互相兼容。常见错误提示如 Minimum supported Gradle version is 8.2，就是 AGP 要求的最低 Gradle 版本高于当前配置。
快速核对方法：
- 打开项目级
build.gradle（或build.gradle.kts），找到com.android.tools.build:gradle的版本号，例如8.5.1； - 查官方兼容表（2026 年最新）：AGP 8.5.x 要求 Gradle 8.4+；
- 再打开
gradle/wrapper/gradle-wrapper.properties，确认distributionUrl指向的是gradle-8.4-bin.zip或更高； - 改完保存后，务必点击工具栏的
Sync Project with Gradle Files，而不是只点 Run。
清理缓存前先分清是哪个缓存
dependency cache may be corrupt 这类报错，不代表整个 .gradle 目录都要删。盲目删掉 ~/.gradle/caches 可能导致下次同步更慢（所有依赖重下），甚至引发权限或符号链接问题。
Android Remote Control
下载
远程控制 Android 设备，支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架，通过 ADB 连接设备，用户无需 Root（1）查看手机屏幕；（2）自动化操作手机 App；（3）远程安装/卸载应用……
推荐按顺序操作：
- 先关掉 Android Studio 和所有
java进程； - 只删
~/.gradle/caches/modules-2/files-2.1（存放下载的依赖 jar/aar）； - 保留
~/.gradle/caches/transforms-3（已解压的 AAR/资源处理结果），它不常损坏； - 如果仍不行，再删
~/.gradle/caches/jars-*和~/.gradle/caches/gradle-kotlin-dsl； - 最后才考虑
Invalidate Caches and Restart，但它会连 IDE 缓存一起清，首次重启明显变慢。
离线模式不是万能的，用错反而同步失败
勾选 Offline work 后，Gradle 完全跳过网络请求，只读本地缓存。但前提是：你之前成功同步过，且所需 Gradle 版本和所有依赖都已完整落盘。
新手最容易踩的坑：
- 第一次打开项目就开离线模式 → 报
Could not resolve all files for configuration； - 手动放了
gradle-8.4-bin.zip到gradle/wrapper/，但没改distributionUrl为file:///路径 → AS 仍尝试联网下载； - 开了离线却换了新模块，该模块依赖未缓存的库 → 同步卡在“Resolving”不动，无报错也无进度。
真正可靠的离线准备方式是：先联网成功同步一次，再断网验证；或者用 ./gradlew --offline build 在终端测试。
