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