android studio卡在“downloading gradle”本质是默认从海外services.gradle.org下载gradle发行包受网络限制，需替换为国内镜像源；首推修改gradle-wrapper.properties中distributionurl为腾讯云地址，并确保版本号一致；再通过全局init.gradle或项目级settings.gradle配置阿里云maven仓库实现依赖加速；离线场景可手动下载解压至本地dists目录并清理缓存重启。
Android Studio新建项目或同步时卡在“Downloading Gradle”阶段，进度条长时间不动甚至报错“Connection timed out”，本质是本地找不到对应版本的Gradle发行包，而默认从海外服务器 services.gradle.org 下载受网络限制。不改配置就反复重试，只会浪费时间且大概率失败。
直接替换Gradle Wrapper下载地址（最快生效）
这一步解决的是Gradle本体（如 gradle-8.13-bin.zip）下载慢的问题，90%的卡顿源于此。
打开项目根目录 → 进入 gradle/wrapper/ 文件夹 → 编辑 gradle-wrapper.properties 文件。
找到以 distributionUrl= 开头的那一行，把整个URL替换成国内镜像地址。
推荐使用腾讯云镜像（稳定、更新及时）：
将原内容：distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
改为：distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.13-bin.zip
⚠️ 注意：版本号（如 8.13）必须与你项目当前要求的Gradle版本完全一致，不能随意修改；否则会触发AGP（Android Gradle Plugin）版本不兼容，导致同步失败。
全局加速所有项目的依赖库下载
只改wrapper地址只能加速Gradle本体，但后续构建中下载 implementation 的库（如 androidx.appcompat:aapptcompat:1.6.1）依然会慢。这需要统一替换Maven仓库源。
方法一：修改全局 init.gradle（推荐，一劳永逸）
Windows路径：C:\Users\你的用户名\.gradle\init.gradle
Mac/Linux路径：~/.gradle/init.gradle
如果文件不存在，请手动创建。
在文件中粘贴以下内容：
allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public' } maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } } }
方法二：项目级配置（适用于团队协作或需版本隔离的场景）
打开项目根目录下的 settings.gradle（新版AS默认使用此文件），在 pluginManagement { repositories { ... } } 和 dependencyResolutionManagement { repositories { ... } } 两个区块内，把 google() 和 mavenCentral() 全部替换为上述阿里云三个URL。
手动下载+本地指定（离线环境或镜像失效时保底）
第一步：访问腾讯云Gradle镜像站：https://www.php.cn/link/64d8893148a469697146699d112348ae，找到你项目所需的版本（例如 gradle-8.13-bin.zip），用浏览器或下载工具直接下载。
第二步：解压该ZIP文件，得到一个名为 gradle-8.13 的文件夹。
第三步：进入本地Gradle缓存目录：
Windows：C:\Users\你的用户名\.gradle\wrapper\dists\
Mac/Linux：~/.gradle/wrapper/dists/
在该目录下，找到形如 gradle-8.13-bin/xxxxx 的子文件夹（xxxxx 是一串随机哈希名，不同机器不同）。
第四步：将解压出的 gradle-8.13 文件夹整个拖入这个子文件夹中，确保路径为：.../gradle-8.13-bin/xxxxx/gradle-8.13/。
第五步：回到Android Studio，点击菜单栏 File → Invalidate Caches and Restart → Invalidate and Restart，重启后重新同步项目。
