Gradle国内环境加速配置指南

一、Gradle本体安装加速（解决distributionUrl下载失败）

问题现象：
执行gradlew时卡在Downloading https://services.gradle.org/distributions/gradle-x.x-bin.zip，因网络无法下载。

解决方案：

1. 手动下载镜像包
   从国内镜像站下载对应版本的Gradle发行包（示例为8.6）：

   # 阿里云镜像
   https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.6-bin.zip
   
   # 腾讯云镜像
   https://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip
   

2. 修改Wrapper配置(推荐)
   在项目根目录的gradle/wrapper/gradle-wrapper.properties中，替换distributionUrl为国内镜像地址：

   distributionUrl=https\://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.6-bin.zip
   

3. 手动放置文件（可选）
   若自动校验失败，将下载的ZIP文件放入本地缓存目录：

   # 路径示例（随机字符目录需自动生成）
   ~/.gradle/wrapper/dists/gradle-8.6-bin/<随机目录>/gradle-8.6-bin.zip
   

二、Gradle依赖加速（配置build.gradle镜像源）

问题现象：
项目构建时卡在Download https://repo.maven.apache.org/...，依赖下载极慢或失败。

解决方案：
在项目的build.gradle文件中添加国内镜像仓库：

Groovy DSL 配置

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' }
    
    // 中央仓库（备用）
    mavenCentral()
}

Kotlin DSL 配置（build.gradle.kts）

repositories {
    maven {
        url = uri("https://maven.aliyun.com/repository/public")
    }
    maven {
        url = uri("https://maven.aliyun.com/repository/google")
    }
    maven {
        url = uri("https://maven.aliyun.com/repository/gradle-plugin")
    }
    mavenCentral()
}

注意：当使用镜像插件下载失败的时候记得把官方仓库给优先放上去，可能是因为镜像里没有当前插件版本（经验之谈）

注意事项

1. 验证Gradle本体安装
   执行命令检查版本是否匹配：

   ./gradlew --version
   

2. 常见问题

   • 镜像不生效：确保repositories配置在buildscript和allprojects块中。
   • 缓存干扰：清理旧缓存：rm -rf ~/.gradle/caches/modules-2/
   • HTTPS证书问题：镜像地址使用http（非推荐）或更新系统证书库。

总结流程图

通过**修改distributionUrl + 配置build.gradle镜像**，可彻底解决Gradle在国内环境下的安装与依赖问题。