修改settings.xml的部分配置阿里云镜像源可显著提升maven依赖下载速度;需在全局(maven安装目录conf/)或用户目录(~/.m2/)下settings.xml中添加对应配置,central仅代理中央仓库,https地址为https://maven.aliyun.com/repository/public,并可通过mvn -x命令验证生效。

直接改 settings.xml 文件里的 <mirrors></mirrors> 部分,把请求转向国内镜像源,比如阿里云,就能明显加快依赖下载速度。
找到并打开 settings.xml 文件
这个文件控制 Maven 的全局行为,修改它会影响所有项目。有两个常见位置:
-
全局配置(推荐初学者用):Maven 安装目录下的
conf/settings.xml,例如D:\apache-maven-3.8.6\conf\settings.xml -
用户配置(适合多环境或团队协作):用户主目录下的
.m2/settings.xml,Windows 是C:\Users\用户名\.m2\settings.xml,Linux/macOS 是~/.m2/settings.xml
如果用户目录下没有这个文件,可以复制一份全局的过去再编辑。
添加阿里云镜像配置
在 settings.xml 中找到 <mirrors></mirrors> 标签(如果没有就手动加上),在里面插入一段镜像定义:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
<mirror><id>aliyun-maven</id><mirrorof>central</mirrorof><name>Aliyun Maven Mirror</name><url>https://maven.aliyun.com/repository/public</url></mirror>
关键点说明:
-
<id></id>是唯一标识,不能重复,建议用有意义的名字如aliyun-maven -
<mirrorof>central</mirrorof>表示只代理中央仓库;如果想代理所有远程仓库,可改成* -
<url></url>必须用 HTTPS(推荐),结尾不需要加斜杠
验证配置是否生效
保存文件后,执行命令检查 Maven 是否读取了新配置:
- 运行
mvn -X clean compile,查看日志里下载依赖时访问的是不是maven.aliyun.com - 或者新建一个简单项目,执行
mvn dependency:resolve,观察首次下载依赖的速度变化 - 也可以删掉本地仓库中某个已有的依赖(比如
~/.m2/repository/junit/),再重新构建,看它是否从镜像地址拉取
其他常用镜像源参考
如果阿里云偶尔不稳定,可替换为其他国内源:
-
腾讯云:
https://mirrors.cloud.tencent.com/nexus/repository/maven-public/ -
华为云:
https://repo.huaweicloud.com/repository/maven/ -
网易:
http://mirrors.163.com/maven/repository/maven-public/
注意:多个镜像同时配置时,Maven 按 <mirrors></mirrors> 中的顺序匹配,优先使用第一个能匹配上的。










