Gradle在国内配置镜像加速的实现步骤

更新时间：2025年05月08日 09:16:19 作者：孽小倩

在国内使用 Gradle 构建项目时,最大的痛点就是依赖下载贼慢,甚至卡死,下面教你如何配置国内镜像加速 Gradle 下载依赖,主要是通过改写 repositories 中的源地址来实现,亲测有效,需要的朋友可以参考下

引言

在国内使用 Gradle 构建项目时，最大的痛点就是依赖下载贼慢，甚至卡死。下面教你如何配置国内镜像加速 Gradle 下载依赖，主要是通过改写 repositories 中的源地址来实现。亲测有效。

一、修改 build.gradle 或 settings.gradle 的 repositories 配置

把默认的 jcenter()、mavenCentral() 或 google() 替换成国内镜像，比如阿里云或清华。

示例：使用阿里云加速

repositories {
    maven { url 'https://maven.aliyun.com/repository/public' }      // Maven Central
    maven { url 'https://maven.aliyun.com/repository/jcenter' }     // JCenter
    maven { url 'https://maven.aliyun.com/repository/google' }      // Google
    maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } // Gradle 插件
}

或者使用清华镜像（也比较稳定）

repositories {
    maven { url 'https://mirrors.tuna.tsinghua.edu.cn/maven/central/' }
    maven { url 'https://mirrors.tuna.tsinghua.edu.cn/gradle/' }
}

二、修改全局配置（推荐用于多项目）

如果你不想每个项目都写一次，可以配置到全局：

路径：

Linux / macOS: ~/.gradle/init.gradle
Windows: C:\Users\<你的用户名>\.gradle\init.gradle

内容如下（自动全局替换 Maven 仓库为阿里云）：

allprojects {
    repositories {
        all { ArtifactRepository repo ->
            if (repo instanceof MavenArtifactRepository) {
                def url = repo.url.toString()
                if (url.contains('jcenter.bintray.com')) {
                    repo.setUrl('https://maven.aliyun.com/repository/jcenter')
                }
                if (url.contains('mavenCentral')) {
                    repo.setUrl('https://maven.aliyun.com/repository/central')
                }
                if (url.contains('plugins.gradle.org')) {
                    repo.setUrl('https://maven.aliyun.com/repository/gradle-plugin')
                }
                if (url.contains('dl.google.com')) {
                    repo.setUrl('https://maven.aliyun.com/repository/google')
                }
            }
        }
    }
}

这样就能实现“偷偷地换源”，你原来 build.gradle 里啥都不用动。

三、代理加速（配合魔法使用）

在 ~/.gradle/gradle.properties 文件中加上代理设置：

systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890

你也可以使用环境变量配置：

export GRADLE_OPTS="-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=7890 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=7890"

检查是否生效

执行构建命令并加上 --info，例如：

./gradlew build --info

可以看到使用了哪个仓库 URL，如果是 aliyun.com 或 tuna.tsinghua.edu.cn 就说明成功了。

到此这篇关于Gradle在国内配置镜像加速的实现步骤的文章就介绍到这了,更多相关Gradle国内配置镜像加速内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java中equals()知识点总结
在本篇文章里小编给大家分享的是关于Java中equals()知识点总结内容，需要的朋友们可以学习参考下。
2020-03-03
Java switch语句支持哪些类型以及原理详解
Java中的switch语句是一种多分支选择结构,它允许一个变量的值等于多个不同的常量时执行不同的代码块,这篇文章主要介绍了Java switch语句支持哪些类型以及原理的相关资料,需要的朋友可以参考下
2025-08-08
Java8中常见函数式接口的使用示例详解
在 Java 8 中,函数式接口是一个关键的特性,它们允许将方法作为参数传递或返回类型,本文为大家整理了一些常见的函数式接口的使用,希望对大家有所帮助
2023-12-12
详解java调用存储过程并封装成map
这篇文章主要介绍了详解java调用存储过程并封装成map的相关资料,希望通过本文能帮助到大家实现这样的功能，需要的朋友可以参考下
2017-09-09
Spring MVC中使用Google kaptcha验证码的方法详解
kaptcha 是一个非常实用的验证码生成工具。有了它，你可以生成各种样式的验证码，因为它是可配置的，下面这篇文章主要给大家介绍了关于Spring MVC中使用Google kaptcha验证码的方法，需要的朋友可以参考借鉴，下面来一起看看吧。
2017-10-10
Spring boot整合mybatis实现过程图解
这篇文章主要介绍了Spring boot整合mybatis实现过程图解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-08-08
SpringBoot构建ORM框架的方法步骤
本文主要介绍了SpringBoot构建ORM框架的方法步骤，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-02-02
Springboot jdbctemplate整合实现步骤解析
这篇文章主要介绍了Springboot jdbctemplate整合实现步骤解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-08-08
如何解决报错:java.net.BindException:无法指定被请求的地址问题
在Linux虚拟机上安装并启动Tomcat时遇到启动失败的问题,通过检查端口及配置文件未发现异常,后发现/etc/hosts文件中缺少localhost的映射,添加后重启Tomcat成功,Tomcat启动时会检查localhost的IP映射,缺失或错误都可能导致启动失败
2024-10-10
浅谈hibernate急迫加载问题(多重外键关联)
这篇文章主要介绍了浅谈hibernate急迫加载问题(多重外键关联)，具有一定借鉴价值，需要的朋友可以参考下。
2017-12-12