Maven 安装配置一条龙：环境变量 + 阿里云镜像，一条命令全搞定

安装 Maven 看似简单，实际上有三个让人头疼的环节：从 Apache 官网下载慢、手动配置 MAVEN_HOME 和 PATH，以及最容易被忽略的——配置 settings.xml 切换国内镜像。尤其是第三点，不少人装完 Maven 就直接开干，结果 mvn install 拉依赖时对着 Maven Central 龟速下载，半小时过去进度条纹丝不动。

传统安装：六步缺一不可

手动安装 Maven 的完整流程：

1. 打开 Apache Maven 官网，找到 Binary zip 下载链接，等待漫长的下载（国内直连 Apache 服务器经常只有几十 KB/s）
2. 解压到某个目录，比如 D:\apache-maven-3.9.9
3. 打开"系统属性" → "高级" → "环境变量"，新建 MAVEN_HOME，值填 Maven 的安装路径
4. 编辑 PATH，添加 %MAVEN_HOME%\bin
5. 手动创建 %USERPROFILE%\.m2\settings.xml，写入阿里云镜像配置
6. 打开新的终端，执行 mvn --version 验证

六步里前四步和装 JDK 差不多，属于"环境变量仪式"。但第五步才是真正的分水岭。

settings.xml：最容易踩的坑

Maven 默认从 Maven Central（repo.maven.apache.org）下载依赖，服务器在海外，国内访问速度极不稳定。解决办法是在 ~/.m2/settings.xml 里配置阿里云镜像：

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Aliyun Maven Central Mirror</name>
    <url>https://maven.aliyun.com/repository/central</url>
  </mirror>
</mirrors>

问题在于，这一步没有任何安装教程会自动帮你完成。很多初学者装完 Maven 后根本不知道还有这个文件要配，第一次运行 mvn install 就被依赖下载速度劝退。更有甚者，在网上搜到过时的镜像地址，配上去照样不好使。

用 hudo 一条命令全搞定

hudo 是一个 Windows 开发环境引导工具，安装 Maven 只需要：

hudo install maven

这一条命令会自动完成以下所有操作：

• 下载 Maven：从 Apache 官方源下载，失败时自动回退到华为云镜像，国内网络也能顺畅下载
• 解压并安装：自动解压到 hudo 管理的目录（D:\hudo\tools\maven）
• 设置环境变量：自动配置 MAVEN_HOME 并将 bin 目录添加到用户 PATH
• 生成 settings.xml：自动在 ~/.m2/ 下创建 settings.xml，预置阿里云中央仓库镜像
• 检测 JDK 依赖：Maven 运行必须有 JDK，hudo 会自动检测，如果未安装会提示你先装 JDK

整个过程无需打开"系统属性"，无需手动编辑 XML 文件，连 JDK 依赖都帮你想到了。

安装后验证

安装完成后，打开一个新的终端窗口：

mvn --version

看到类似以下输出即表示安装成功：

Apache Maven 3.9.9
Maven home: D:\hudo\tools\maven
Java version: 21.0.6, vendor: Eclipse Adoptium

可以进一步创建一个测试项目来验证镜像是否生效：

mvn archetype:generate -DgroupId=com.test -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

如果依赖下载速度明显很快（几秒内完成），说明阿里云镜像已经在工作了。

总结

Maven 安装的真正难点不在于安装本身，而在于那些"安装之后"的配置工作。环境变量要配对，settings.xml 不能漏，镜像地址要正确。与其每次都重复这套流程，不如用 hudo install maven 一步到位——下载、解压、环境变量、阿里云镜像，全部自动搞定。