Maven安装配置教程详解

本文详细讲解了Java开发者如何正确安装与配置Maven：从官网下载二进制压缩包（非安装程序）、解压至无中文无空格路径，到精准设置M2_HOME和PATH环境变量，再到验证JDK版本兼容性（如Maven 3.9+需JDK 17+），并手把手指导配置阿里云镜像解决国内首次构建卡顿问题——每一步都直击新手高频踩坑点，帮你避开“mvn -v失败”“UnsupportedClassVersionError”“镜像不生效”等典型陷阱，真正实现开箱即用。

下载Maven二进制包而不是安装程序

Maven没有Windows/macOS/Linux通用的“安装程序”，官方只提供apache-maven-*.zip或.tar.gz压缩包。直接去官网下载页选最新稳定版（如apache-maven-3.9.7-bin.zip），解压到不含中文和空格的路径，例如C:\tools\apache-maven-3.9.7或/opt/maven。

常见错误：用浏览器自动解压、双击打开后改名、解压到Downloads或桌面——这些路径容易触发权限或空格问题，后续mvn -v会失败。

配置M2_HOME和PATH环境变量

必须设置两个环境变量，缺一不可：

• M2_HOME 指向Maven解压后的根目录（不含bin），例如C:\tools\apache-maven-3.9.7
• PATH 追加%M2_HOME%\bin（Windows）或$M2_HOME/bin（macOS/Linux）

验证方式：新开终端运行mvn -v。如果报错'mvn' is not recognized，说明PATH没生效；如果报Could not find or load main class org.apache.maven.cli.MavenCli，大概率是M2_HOME路径写错或指向了bin目录内部。

检查Java版本是否满足Maven要求

Maven 3.9+ 要求JDK 17+，但很多项目仍用JDK 8/11。运行mvn -v时若看到类似UnsupportedClassVersionError，就是JDK太老。此时有两个选择：

• 升级JDK（推荐长期项目）
• 降级Maven（例如改用apache-maven-3.8.8，它支持JDK 8+）

注意：mvn -v输出里第一行显示的是Maven用的JDK，不是你java -version当前默认的——两者可能不同，尤其当你装了多个JDK时。

首次运行mvn archetype:generate会卡住

这是正常现象：Maven要从中央仓库下载大量插件和原型（archetype），国内直连非常慢，甚至超时失败。解决办法是配阿里云镜像：

编辑$M2_HOME/conf/settings.xml（若不存在则复制conf/settings.xml.template），在标签内加入：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>Aliyun Maven</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

改完保存，再执行命令就会快很多。别漏掉*，否则镜像不生效。

真正容易被忽略的是：很多人改了settings.xml却没重启终端，或者误改了用户目录下的~/.m2/settings.xml（优先级更高，但初学者常找不到），结果配置看似写了，实际没走。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~