全局配置Gradle阿里云镜像源

1. 配置Gradle环境变量

本小节提到两个环境变量:GRADLE_HOME(非必须)、GRADLE_USER_HOME

环境变量 作用
GRADLE_HOME 配置本地Gradle安装目录,将%GRADLE_HOME%\bin放在Path中,可以全局使用gradle相关命令
GRADLE_USER_HOME Gradle配置文件读取目录、下载包存储目录等多项Gradle数据存储在该目录下

所以如果我们希望阿里云镜像源在全局生效
就需要将相关配置放在GRADLE_USER_HOME目录中
GRADLE_USER_HOME目录默认是C:\User\Username\.gradle
如果可以接受GRADLE_USER_HOME默认路径的
也可以不配置这个环境变量

2. 新建阿里云镜像源配置文件

在%GRADLE_USER_HOME%所指向的目录下
新建一个init.d文件夹(如果没有的话)
init.d文件夹下的所有以.gradle或.gradle.kts为后缀的文件
都会被Gradle识别为全局配置文件
我们新建一个aliyun.gradle.kts文件作为阿里云镜像源配置文件(按个人喜好命名即可)
内容如下

val aliyunRepository = "https://maven.aliyun.com/repository/public/"

gradle.settingsEvaluated {

  pluginManagement {

    repositories {
      maven {
        url = uri(aliyunRepository)
      }
    }

  }

}

allprojects {

  repositories {
    maven {
      url = uri(aliyunRepository)
    }
  }

}

3. 项目指定版本Gradle下载失败

有些同学通过Git拉下来一个新项目后
该项目中自带有gradle/wrapper/gradle-wrapper.properties文件
但是本地环境中没有配置文件中指定版本的Gradle时
可能会碰到下载Gradle失败的情况
将distributionUrl配置的下载地址换成阿里云镜像源即可(注意Gradle版本号要以原项目所指定的版本为准)

## 项目配置文件中的原下载路径
distributionUrl=https\://services.gradle.org/distributions/gradle-8.8-bin.zip
## 改为阿里云镜像源下载路径(版本不变)
distributionUrl=https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.8-bin.zip
posted @ 2025-10-26 13:53  PlaidShirtWholesaler  阅读(41)  评论(0)    收藏  举报