安卓gradle下载慢解决方案

Huanzhi_Lin2025-12-02 10:15

文章目录

原因
方案一（推荐）
方案二

原因

Android Studio 中从 https://services.gradle.org/distributions/gradle-8.0-bin.zip 下载速度慢，主要是因为该地址是Gradle的官方服务器，服务器位于国外，国内访问时容易受到网络不稳定、公司防火墙限制或地区网络屏蔽的影响，导致连接超时或速度缓慢。

方案一（推荐）

找到配置文件：在Android项目根目录下，找到并打开 gradle/wrapper/gradle-wrapper.properties 文件。
替换下载地址：找到 distributionUrl 这一行，将其中的官方地址替换为国内镜像地址，例如腾讯云镜像。
例子

bash 复制代码

修改前：distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip

修改后：distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

重新同步项目：在Android Studio中点击 "Sync Project with Gradle Files" 按钮，此时Gradle将自动从国内镜像快速下载。

方案二

如果镜像地址仍然不稳定，可以采用此方法彻底避免网络问题

手动下载：使用浏览器或下载工具（如迅雷）直接下载 gradle-8.0-bin.zip 文件。可以从腾讯云镜像站（https://mirrors.cloud.tencent.com/gradle/）下载。
存放文件：将下载好的ZIP文件放在一个固定的本地目录中，例如 D:\dev-tools\gradle\（Windows）或 /Users/Shared/gradle/（macOS）。
修改配置指向本地文件：同样在 gradle-wrapper.properties 文件中，将 distributionUrl 修改为指向本地文件的路径。

bash 复制代码

Windows示例：distributionUrl=file:///D:/dev-tools/gradle/gradle-8.0-bin.zip

macOS示例：distributionUrl=file:///Users/Shared/gradle/gradle-8.0-bin.zip 

要点：路径必须以 file:/// 开头，并使用正斜杠(/)分隔。

完成上述任一方案后，重新同步项目即可。如果之后下载项目依赖库（Jar包）的速度也慢，可以参照类似方法，在项目根目录的 build.gradle 文件中将仓库地址（如 jcenter() 或 mavenCentral()）替换为阿里云等国内镜像地址。