maven需配置镜像源加速依赖下载，应修改用户级~/.m2/settings.xml（推荐）或全局conf/settings.xml，镜像配置须置于标签内，使用*拦截全部请求，推荐阿里云https://maven.aliyun.com/repository/public，并验证url可用性及ide设置。
Maven 默认从中央仓库下载依赖，国内直连慢且不稳定，必须配置镜像源才能正常开发。
修改 settings.xml 文件位置是否正确
不是改项目里的 pom.xml，也不是改 IDE 内嵌的 Maven 配置，而是改 Maven 自身的全局或用户级 settings.xml：
- 全局配置：在 Maven 安装目录下的
conf/settings.xml（需管理员权限修改） - 用户级配置（推荐）：在
~/.m2/settings.xml（Windows 是%USERPROFILE%\.m2\settings.xml），不存在就手动创建 - IDE（如 IntelliJ）会优先读取用户级配置；若同时存在全局和用户级，用户级生效
镜像配置写法必须放在 <mirrors></mirrors> 标签下
常见错误是把 <mirror></mirror> 块直接塞进 <profiles></profiles> 或 <servers></servers> 里，这完全无效。正确结构是：
<settings>
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
</settings>
-
<mirrorof>*</mirrorof>表示拦截所有仓库请求（包括 central、spring-plugins 等） - 若只想代理中央仓库，用
<mirrorof>central</mirrorof>；但多数国产镜像不完整支持非 central 仓库，*更稳妥 -
<id></id>值不能重复，且不能含下划线（部分旧版 Maven 会解析失败），推荐用连字符如aliyun-maven
阿里云、华为云、腾讯云镜像地址与兼容性差异
主流镜像源 URL 已更新，旧文档中 http:// 或带 /nexus/ 路径的地址多数已失效：
立即学习“Java免费学习笔记（深入）”；
- 阿里云（最稳定）：
https://maven.aliyun.com/repository/public - 华为云：
https://repo.huaweicloud.com/repository/maven/（注意末尾斜杠不能少） - 腾讯云：
https://mirrors.cloud.tencent.com/nexus/repository/maven-public/ - 清华源已停止 Maven 镜像服务，
https://mirrors.tuna.tsinghua.edu.cn/nexus/repository/maven-public/返回 404 - 使用前建议浏览器直接访问 URL，确认返回 200 且页面含 “Index of /”
验证镜像是否生效的三个关键动作
改完 settings.xml 后不重启 IDE 或清缓存，大概率还在走原仓库：
- 执行
mvn -X clean compile，观察日志中下载依赖时的 URL 是否变成你配的镜像域名 - 删掉本地
~/.m2/repository/下某个常用包（如org/springframework/spring-core），再重装，看新下载路径 - IntelliJ 用户：File → Settings → Build → Build Tools → Maven → 取消勾选 “Use default settings”，并指定你修改后的
settings.xml路径
镜像配置本身很简单，但生效链路长——文件位置、XML 结构、URL 可用性、IDE 缓存四者任一出错都会导致“明明改了却没加速”。
