改阿里云镜像源可提速3–10倍，但需确保IDEA使用本地Maven、正确配置settings.xml中标签及central，并清理缓存、检查非central仓库依赖。
直接换阿里云镜像源，能提速 3–10 倍，但光改 settings.xml 不一定生效，关键在改对位置、配对格式、避开 IDEA 自带的 Maven 冲突。
确认 IDEA 用的是哪个 Maven 实例
很多人改了本地 ~/.m2/settings.xml 却没效果，是因为 IDEA 默认不读它——IDEA 会优先用自带的 Maven（plugins/maven/lib/maven3），或你手动指定的路径。必须进设置里看清楚：
- 打开 File → Settings → Build → Build Tools → Maven
- 检查
Maven home path：如果是Bundled (Maven 3.x)，那它根本不会读你用户目录下的settings.xml - 想走自定义配置，得选
Use specified installation，并指向你本地安装的 Maven（比如/opt/homebrew/Cellar/maven/3.9.6） - 同时确保
User settings file指向你改过的settings.xml（推荐放~/.m2/settings.xml）
阿里云镜像源配置要写对位置和格式
镜像必须放在 <mirrors></mirrors> 标签下，且 <id></id> 不能重复、<mirrorof></mirrorof> 要覆盖中央仓库。常见错法：写到 <profiles></profiles> 里，或漏掉 <mirrorof>central</mirrorof>。
正确片段（直接贴进 ~/.m2/settings.xml 的 <mirrors></mirrors> 内）：
<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
-
<mirrorof>central</mirrorof>是关键，表示“把所有对 central 的请求都转给这个镜像” - 别写
<mirrorof>*</mirrorof>——某些老插件会因此跳过认证或失败 - 如果公司私有仓库也用了
central作为 id，这里会冲突，得改成<mirrorof>!my-private-repo,central</mirrorof>
改完不生效？检查这三处缓存和权限
IDEA 不是改完就立刻重拉依赖的，它会复用本地已有的 .lastUpdated 文件标记，甚至缓存仓库元数据。
- 删掉项目下的
target和.idea/libraries目录（强制 IDEA 重解析依赖） - 删掉
~/.m2/repository/.cache/下的maven-metadata-central.xml类文件 - 检查
~/.m2/settings.xml文件权限：如果 IDEA 是以其他用户身份运行（比如通过桌面快捷方式启动），可能读不到你的用户目录配置——可临时复制一份到 IDEA 指定的User settings file路径下 - 在 IDEA 终端执行
mvn -X dependency:resolve，看日志里下载 URL 是否变成maven.aliyun.com
为什么有时候还是慢？注意依赖传递链里的非 central 仓库
阿里云镜像只代理 central，但很多项目依赖会声明自己的仓库，比如 Spring Snapshot、JFrog、GitHub Packages。这些请求不会走阿里云，依然卡在原始地址。
- 用
mvn help:effective-pom查看最终生效的 pom，搜<repository></repository>看有没有非 central 的源 - 若必须用 snapshot 版本，可单独为它加一个镜像，
<mirrorof>spring-snapshots</mirrorof>，但注意阿里云不提供 snapshot 镜像，得换清华或北外源 - 某些
pom.xml里写了<repository><id>central</id></repository>但 URL 指向了私有 Nexus——这时镜像失效，得统一改 Nexus 配置或删掉该 repository 声明
真正卡住的时候，往往不是中央仓库慢，而是某个间接依赖悄悄引入了没配镜像的第三方仓库。查日志比盲目换源更管用。
