下载Maven二进制包并解压到无中文无空格路径，配置M2_HOME和PATH环境变量，确保JDK版本匹配（Maven 3.9+需JDK 17+），再配置阿里云镜像加速首次构建。
下载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免费学习笔记（深入）”；
检查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），在
aliyunmaven * Aliyun Maven https://maven.aliyun.com/repository/public
改完保存，再执行命令就会快很多。别漏掉
真正容易被忽略的是：很多人改了settings.xml却没重启终端，或者误改了用户目录下的~/.m2/settings.xml（优先级更高，但初学者常找不到），结果配置看似写了，实际没走。
