方法一:使用国内镜像源(推荐)
这是最常用且高效的方法,通过切换到国内镜像服务器,可显著提升下载速度和成功率。
-
打开你的项目目录,找到
gradle/wrapper/gradle-wrapper.properties文件。 -
找到
distributionUrl这一行,将其内容修改为以下国内镜像地址之一:- 腾讯云镜像(推荐):
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.14-bin.zip - 阿里云镜像:
distributionUrl=https://mirrors.aliyun.com/gradle/gradle-8.14-bin.zip - 华为云镜像:
distributionUrl=https://repo.huaweicloud.com/gradle/gradle-8.14-bin.zip
- 腾讯云镜像(推荐):
-
保存文件,并在 Android Studio 中点击 Sync Project 或重新构建项目。
方法二:手动下载并本地配置
如果镜像源仍无法下载,可以手动下载后放置到本地缓存目录。
- 手动下载: 访问 Gradle 官方发布页面 或 阿里云镜像仓库,下载
gradle-8.14-bin.zip文件。 - 找到本地缓存目录: 默认情况下,Gradle 会将下载的分发包存放在
~/.gradle/wrapper/dists/目录下(Windows 系统通常为C:\Users<你的用户名>.gradle\wrapper\dists)。 - 定位并替换文件: 在
dists目录下,找到一个以gradle-8.14-bin命名的文件夹(里面会有一串随机字符的子文件夹)。进入该子文件夹,删除其中的所有文件,然后将你手动下载的gradle-8.14-bin.zip文件复制粘贴到这里。 - 重启 IDE: 重启 Android Studio,项目同步时就会直接使用你本地提供的文件,无需再下载。
方法三:使用 gradle-all.zip 包(彻底解决源码下载问题)
有开发者反馈,即使配置了 bin.zip,IDE(如 IntelliJ IDEA)仍会尝试下载额外的源码包(gradle-src.zip),导致速度慢。使用 all.zip 包可以一劳永逸地解决此问题。
- 在
gradle-wrapper.properties文件中,将distributionUrl修改为:
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.14-all.zip
(或使用阿里云、华为云的all.zip镜像) - 重要提示: 如果你之前下载过
bin.zip并放置在本地缓存目录,请先删除该目录下的所有文件,再放入all.zip包,否则 Gradle 会因校验和(checksum)不匹配而报错。 - 保存并同步项目。
all.zip包包含了二进制文件和源码,能避免 IDE 额外的网络请求。12