Android Studio Gradle下载太慢,国内怎么最快加速

张开发
2026/4/13 13:03:53 15 分钟阅读

分享文章

Android Studio Gradle下载太慢,国内怎么最快加速
Gradle 下载慢是 Android 开发中最令人头疼的问题之一主要原因是默认的 Maven Central 和 Google 仓库服务器都在国外。要实现“最快加速”你需要同时解决两个层面的下载问题Gradle 本体下载慢下载 gradle-x.x.x-bin.zip。依赖库下载慢下载 implementation 的 jar/aar 包。以下是目前国内最主流、最有效的加速方案推荐组合使用 第一步加速 Gradle 本体下载二选一当你新建项目或升级 Gradle 版本时Android Studio 会尝试下载 Gradle 发行版。默认地址在国外速度极慢。方法 A修改项目配置最简单推荐打开你的项目找到文件gradle/wrapper/gradle-wrapper.properties。找到 distributionUrl 这一行。将默认的 services.gradle.org 地址替换为腾讯云或阿里云的镜像地址。修改前distributionUrlhttps://services.gradle.org/distributions/gradle-8.2-bin.zip修改后使用腾讯云镜像distributionUrlhttps://mirrors.cloud.tencent.com/gradle/gradle-8.2-bin.zip(注请将 gradle-8.2-bin.zip 替换为你项目实际需要的版本号)方法 B手动下载如果方法 A 依然失败如果脚本下载依然卡住你可以直接用浏览器或迅雷去腾讯云/阿里云镜像站下载对应的 .zip 包然后解压到你用户目录下的 .gradle/wrapper/dists/ 对应文件夹中。 第二步加速依赖库下载一劳永逸这是解决 build.gradle 中 implementation 依赖下载慢的关键。建议配置全局代理这样你电脑上所有的 Android 项目都能自动加速无需每个项目都改。推荐方案配置阿里云镜像全局生效找到配置文件Windows: C:Users你的用户名.gradleinit.gradleMac/Linux: ~/.gradle/init.gradle(如果 .gradle 文件夹或 init.gradle 文件不存在请手动创建)写入以下代码这段代码会将所有项目的仓库请求重定向到阿里云同时保留 Google 仓库也通过阿里云代理。allprojects {repositories {// 阿里云公共仓库替代 mavenCentralmaven { url ‘https://maven.aliyun.com/repository/public’ }// 阿里云 Google 仓库替代 google maven { url https://maven.aliyun.com/repository/google } // 阿里云 Gradle 插件仓库 maven { url https://maven.aliyun.com/repository/gradle-plugin } // 备用如果阿里云没有再去官方源可选建议保留以防万一 // mavenCentral() // google() }}生效保存文件后重启 Android Studio点击 “Sync Project with Gradle Files”你会发现下载速度瞬间起飞通常能达到 5MB/s - 10MB/s。️ 第三步解决 SDK 下载慢可选如果你在安装 Android SDK 组件时也慢可以配置 SDK Manager 的镜像。打开 SDK Manager。在 SDK Update Sites 标签页中。将默认的 Google 地址替换为清华大学开源软件镜像站https://mirrors.tuna.tsinghua.edu.cn/android-sdk/ 常见问题排查配置了还是慢检查是否开启了全局代理软件有时代理软件会拦截 Gradle 的请求导致死循环。尝试在 Gradle 配置中关闭代理或者在代理软件中设置规则让 Gradle 直连因为阿里云本身就是国内的不需要走国外代理。报错 Could not find …阿里云镜像虽然覆盖很全但极少数非常新的库可能同步有延迟。如果遇到这种情况可以在项目的 build.gradle 中临时添加 mavenCentral() 或 google() 官方源作为备选。通过以上配置你的 Gradle 构建速度应该会有质的飞跃。

更多文章