在使用 Android Studio（尤其是最新版 Rabbit 等）新建安卓项目时，由于默认的 Gradle 下载源和依赖仓库都在国外，国内开发者经常会遇到新建项目后一直卡在 Downloading gradle-xxx.zip 或者 Generating sources 几个小时不动的情况。
为了彻底解决这个痛点，避免 C 盘爆满并提升编译速度，我们需要将下载源替换为国内的镜像。以下是我亲测有效、能让下载速度“起飞”的配置记录，分为核心构建工具加速和第三方依赖库加速两步。
第一步：配置 Gradle 本体下载源（腾讯云镜像）
当我们第一次新建项目或更新 Gradle 版本时，系统需要下载一个一百多兆的 Gradle 核心压缩包。如果直接连官方源，经常会卡在 0% 或中途超时。
修改文件： 打开项目根目录下的 gradle/wrapper/gradle-wrapper.properties 文件。
修改方法： 将原本的 distributionUrl 替换为腾讯云的镜像地址。完整配置如下：
#Wed Oct 14 23:58:15 CST 2026
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionSha256Sum=bbaeb2fef8710818cf0e261201dab964c572f92b942812df0c3620d62a529a01
# 将原本的 services.gradle.org 替换为腾讯云镜像
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.6.0-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
提示： 这里的
gradle-9.6.0-bin.zip请根据你实际项目所需的版本号保留，只替换前面的域名前缀即可。
第二步：配置项目依赖包下载源（阿里云镜像）
解决了 Gradle 本体的下载后，还需要解决项目中用到的各种第三方库（如 androidx、google 组件等）的下载速度问题。
修改文件： 打开项目根目录下的 settings.gradle.kts 文件（如果是老版本项目则是 settings.gradle）。
修改方法： 在 pluginManagement 和 dependencyResolutionManagement 这两个模块中的 repositories 列表最上方，优先插入阿里云的 Maven 镜像地址。由于 Gradle 是自上而下寻找依赖的，放在最前面能确保优先走国内高速通道。
完整配置代码如下：
pluginManagement {
repositories {
// 优先使用阿里云镜像加速
maven { url = uri("https://maven.aliyun.com/repository/google") }
maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
maven { url = uri("https://maven.aliyun.com/repository/public") }
// 官方源作为兜底
google {
content {
includeGroupByRegex("com\\.android.*")
includeGroupByRegex("com\\.google.*")
includeGroupByRegex("androidx.*")
}
}
mavenCentral()
gradlePluginPortal()
}
}
plugins {
id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
// 优先使用阿里云镜像加速
maven { url = uri("https://maven.aliyun.com/repository/google") }
maven { url = uri("https://maven.aliyun.com/repository/central") }
maven { url = uri("https://maven.aliyun.com/repository/public") }
// 官方源作为兜底
google()
mavenCentral()
}
}
rootProject.name = "appdemo"
include(":app")
验证生效
完成上述两步配置后，点击 Android Studio 编辑器右上角弹出的 🐘 Sync Now（立即同步） 按钮。
此时观察底部的 Build 任务栏，你会发现下载链接已经全部变成了 tencent 和 aliyun 开头的地址，下载速度从几十 KB/s 直接飙升到几 MB/s。等待几十秒到一两分钟，左侧项目目录成功加载出带有绿色安卓机器人图标的 app 文件夹，就说明镜像配置完美生效，环境搭建大功告成！