改 settings.xml 能加速 maven 下载,因为将默认中央仓库替换为国内阿里云镜像(https://maven.aliyun.com/repository/public),物理距离近、带宽足;需修改用户级 ~/.m2/settings.xml(windows 为 %userprofile%.m2\settings.xml),在 中配置 *,并验证日志中下载 url 是否变为 aliyun.com。

为什么改 settings.xml 能加速 Maven 下载
因为默认 Maven 从中央仓库 https://repo.maven.apache.org/maven2/ 拉包,国内直连慢、不稳定。阿里云镜像(https://maven.aliyun.com/repository/public)是官方认可的缓存节点,物理距离近、带宽足,改完后所有 mvn clean install 类命令都会自动走这个源。
怎么改本地 settings.xml 文件
不是改项目里的 pom.xml,也不是改 IDE 内嵌的 Maven 配置,而是改你机器上 Maven 安装目录或用户目录下的全局/用户级 settings.xml:
- 优先改用户级:在
~/.m2/settings.xml(macOS/Linux)或%USERPROFILE%\.m2\settings.xml(Windows)——这个对当前用户生效,不影响别人,也避开权限问题 - 如果文件不存在,就新建一个;如果存在,只补全
<mirrors></mirrors>块,别动已有配置 - 镜像必须设为
<mirrorof>*</mirrorof>,表示“所有仓库都走它”,写成central或public会漏包
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
常见错误现象和验证方法
改完不生效?大概率是路径错、格式错、或者被其他配置覆盖了:
- 执行
mvn -X clean compile看日志里下载 URL 是否变成maven.aliyun.com—— 这是最准的验证方式 - 如果还走
repo.maven.apache.org,检查是否误改了$M2_HOME/conf/settings.xml却没配M2_HOME环境变量,导致 Maven 根本没读它 - IDE(如 IntelliJ)可能缓存旧配置,改完后要重启 IDE 或手动触发 “Reload project”
- 某些公司私有仓库要求保留特定
mirrorOf值(比如external:*),此时不能简单写*,得按内部规范调整
镜像地址和兼容性注意点
阿里云镜像地址有过几次变更,老教程里写的 http://maven.aliyun.com/nexus/content/groups/public/ 已弃用,HTTP 也不安全:
立即学习“Java免费学习笔记(深入)”;
- 必须用 HTTPS,当前稳定地址是
https://maven.aliyun.com/repository/public - 这个地址支持 Maven 3.0+ 所有版本,但如果你用的是极老的 Maven 2.x,可能需要降级到
https://maven.aliyun.com/nexus/content/groups/public(不推荐) - 它只代理 public 仓库,不包含
snapshots或releases等子仓库,所以不要在<repository></repository>里重复配阿里云地址——镜像和仓库配置混用容易冲突
<mirrorof></mirrorof> 写成 *。其它任何花式写法,包括加 profile、套条件、换 id 名,都是在增加出错概率。










