改distributionurl为国内镜像源是最有效解法，因其直接解决gradle wrapper启动时下载卡死问题，且该步骤不依赖其他配置，必须与项目所需版本及后缀（-bin/-all）严格匹配。
直接改 gradle-wrapper.properties 里的 distributionUrl，换国内镜像源，是最有效、最快速的解法。 其他方法（如调超时、清缓存、关防火墙）治标不治本，多数时候连下载入口都进不去。
为什么改 distributionUrl 是第一优先级操作
Gradle Wrapper 启动失败卡在 downloading gradle-x.x-bin.zip，本质是它必须先从远程拉取完整 Gradle 运行时包才能执行后续逻辑。这个下载动作由 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 控制，且**不走任何其他配置（比如 build.gradle 的 repositories 或 IDE 设置）**。也就是说，你改了 Maven 镜像、配了代理、甚至改了 JDK，只要这行 URL 指向 services.gradle.org，就大概率超时。
- 清华镜像稳定、同步延迟 https://mirrors.tuna.tsinghua.edu.cn/gradle/gradle-8.5-bin.zip
- 腾讯云和阿里云也可靠，注意 URL 路径格式要严格匹配版本号和后缀（
-bin.zip或-all.zip） - 改完保存，不要重启 IDE，直接点击 Android Studio / IDEA 的 Sync Now 或运行
./gradlew --version验证
distributionUrl 改完还是超时？检查这几个硬性条件
镜像地址本身没问题，但实际下载仍失败，常见于路径拼写错误或网络策略拦截：
-
distributionUrl值必须以https://开头，不能漏掉s；反斜杠转义仅在 Windows 的.bat文件中需要，.properties文件里直接写正斜杠 - 确认镜像站确实提供你要的版本：打开浏览器访问镜像 URL（例如
https://mirrors.tuna.tsinghua.edu.cn/gradle/），手动找对应gradle-8.12-bin.zip是否存在 - 公司内网或教育网可能屏蔽了镜像域名，可临时用手机热点测试；部分企业防火墙会主动拦截
.zip下载，此时需联系 IT 部门放行 - Windows 用户注意：如果项目路径含中文或空格，
gradlew.bat可能解析异常，建议把项目移到纯英文路径下再试
不想依赖网络？用本地已下载的 Gradle 包
适用于离线环境、CI 构建或反复调试同一版本的场景。关键不是“把 zip 放进某个文件夹”，而是让 Wrapper 绕过下载流程，直读本地解压后的目录：
- 下载对应版本的
gradle-x.x-bin.zip，解压到任意位置（如D:\gradle\gradle-8.5） - 在 IDE 中进入
File > Settings > Build, Execution, Deployment > Gradle（Windows/Linux）或Android Studio > Preferences > Build & Execution > Gradle（macOS） - 勾选
Use Gradle from: Specified location，指向你解压后的根目录（D:\gradle\gradle-8.5），不是 zip 文件，也不是bin子目录 - 取消勾选
Use wrapper from project，否则 IDE 仍会尝试读取gradle-wrapper.properties并触发下载
别碰 gradle.properties 里的超时参数
网上常被推荐的 org.gradle.internal.http.connectionTimeout=60000 等配置，对 Wrapper 下载阶段完全无效。这些参数只影响构建过程中依赖解析（即 repositories{} 那部分），而 distributionUrl 下载走的是独立 HTTP 客户端，不受其控制。强行加了反而可能干扰后续依赖下载逻辑，属于典型误用。
真正容易被忽略的是：镜像 URL 必须与项目所需的 Gradle 版本精确匹配，且后缀（-bin.zip / -all.zip）要和原配置一致；另外，Android 项目还需确保该 Gradle 版本与 com.android.tools.build:gradle 插件兼容——这点不解决，即使下载成功，也会在下一步报 Could not resolve com.android.tools.build:gradle。
