下载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太老。此时有两个选择：
