配置阿里云镜像可将Maven依赖下载转向国内节点，实测速度提升3～8倍、首次构建时间缩短40%以上；需创建用户级~/.m2/settings.xml，写入含<mirrorOf>*</mirrorOf>和https://maven.aliyun.com/repository/public的完整XML配置，并通过mvn命令验证URL是否变为aliyun地址。

在 Maven 构建 Java 项目时，依赖下载慢、超时、失败，根本原因往往是默认连接国外中央仓库（repo.maven.apache.org）——国内直连延迟高、丢包率大。配置阿里云镜像后，90%以上的依赖请求会转向北京/杭州节点，实测下载速度提升 3～8 倍，首次构建时间可缩短 40% 以上。

确认 Maven 已安装并可用

打开终端，执行：
mvn -v
若返回 Apache Maven 版本信息（如 3.9.6），说明已安装；若提示 command not found，请先完成 Maven 安装（Ubuntu 可用 sudo apt install maven，Windows/macOS 需下载解压并配置 PATH）。

优先创建用户级 settings.xml 文件

这一步必须做，否则后续配置无效。
执行命令创建目录和空文件：
mkdir -p ~/.m2 && touch ~/.m2/settings.xml
【注意：不要修改 /usr/share/maven/conf/settings.xml 等全局文件，它可能被系统包管理器覆盖】

写入标准阿里云镜像配置

用 nano、vim 或 VS Code 打开 ~/.m2/settings.xml：
nano ~/.m2/settings.xml

将以下完整 XML 内容粘贴进去（直接覆盖原空文件内容）：

        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
 
   
     aliyunmaven
     *
     阿里云公共仓库
     https://maven.aliyun.com/repository/public
   
 

【关键点：* 表示该镜像接管所有仓库请求，比 central 更彻底；url 必须用 https://maven.aliyun.com/repository/public，旧地址 http://maven.aliyun.com/nexus/... 已停用】

验证镜像是否生效

第一步：清理本地缓存（避免旧依赖干扰判断）
mvn dependency:purge-local-repository -DmanualInclude=*

第二步：触发一次真实依赖拉取
mvn archetype:generate -DgroupId=com.test -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

第三步：观察控制台输出中的下载 URL —— 如果看到大量 https://maven.aliyun.com/... 路径，且无 repo.maven.apache.org 出现，即表示配置成功。