Android Studio 项目通过 gradle-wrapper 自动管理 Gradle 版本，卡在“downloading gradle”是因 distributionUrl 指向国外地址导致下载失败；可手动下载对应-bin.zip 放入 ~/.gradle/wrapper/dists/ 对应路径跳过下载，或修改 distributionUrl 为华为云镜像或本地 file:// 路径；注意 AGP 与 Gradle 版本需兼容，并建议配置 GRADLE_USER_HOME 避免缓存占满系统盘。
不需要额外安装 Gradle，Android Studio 项目默认通过 gradle-wrapper 自动管理对应版本，你装的是 wrapper 而不是 Gradle 本体。
为什么打开新项目会卡在“downloading gradle”
因为 gradle-wrapper.properties 里写的 distributionUrl 指向的是国外地址（如 https://services.gradle.org/...），国内直连大概率超时或失败。这不是 Gradle 没装好，而是下载环节被阻断。
- 检查路径：
{project-root}/gradle/wrapper/gradle-wrapper.properties - 典型失败提示：
Connection timed out或unable to resolve class org.gradle.api.tasks.bundling.Jar（其实是 wrapper 没拉下来，后续构建直接崩） - 真正生效的 Gradle 版本由这个文件决定，和 Android Studio 自带的“Gradle plugin”无关
怎么跳过下载、直接用本地已有的 Gradle
核心是让 wrapper 找到你手动放好的 zip 包，且路径必须严格匹配它预期的结构 —— 它不会解压，但会校验哈希、自动解压到子目录。
- 先让 Android Studio 尝试同步一次，观察日志里报错的 Gradle 版本（比如
gradle-8.7-bin.zip）和它想存的路径（形如~/.gradle/wrapper/dists/gradle-8.7-bin/7a6x2j5vzq9f3t1k4m8n6p2r0/） - 去 华为云 Gradle 镜像 下载对应
-bin.zip文件（别下-all.zip，体积大、慢、没必要） - 把 zip 文件直接丢进上面那个末级目录（不要解压！不要重命名！）
- 重启 Android Studio 或点击
Sync Project with Gradle Files，wrapper 会发现 zip 已存在，跳过下载直接解压使用
修改 distributionUrl 直接指向国内镜像或本地文件
这是最稳妥的预防手段，避免每次新建项目都重蹈覆辙。
- 改在线镜像（推荐）：
distributionUrl=https://www.php.cn/link/0172f0986e6bc89d1304a928d4b09b3fgradle-8.7-bin.zip - 改本地路径（仅限单机调试）：
distributionUrl=file:///D:/gradle/gradle-8.7-bin.zip（注意三斜杠 + 绝对路径） - 别用
https://services.gradle.org，除非你开了稳定代理 - AGP（Android Gradle Plugin）版本和 Gradle 版本有强绑定，查兼容表前别乱升 Gradle 版本（比如 AGP 8.7 只认 Gradle 8.6–8.7）
最容易被忽略的一点：Gradle wrapper 的缓存路径 ~/.gradle/wrapper/dists/ 默认在系统盘，长期开发后可能占几十 GB。建议提前设好 GRADLE_USER_HOME 环境变量指向非系统盘，否则某天 C 盘爆满，连 sync 都触发不了。
