先运行 mvn -v 检查是否预装及版本，若未安装或版本低于 3.8.0 则需升级；推荐用 SDKMAN! 安装管理多版本，次选手动解压配置环境变量与阿里云镜像源，并确保 JDK 版本与 Maven 兼容。
检查系统是否已预装 Maven
很多 Linux 发行版（尤其是 Ubuntu/Debian 的某些桌面镜像或开发环境）会自带 mvn，但版本往往过旧（比如 3.6.x），甚至只是 maven 包的空壳，实际没装 mvn 命令。直接运行 mvn -v，如果报 command not found，说明没装；如果输出版本但低于 3.8.0，大概率不兼容较新项目的 pom.xml（比如用了 <dependencyManagement> 中的 BOM 导入方式时会失败）。
实操建议：
- 先执行
which mvn和mvn -v确认是否存在、路径在哪、版本号是多少 - Ubuntu/Debian 用户别急着
sudo apt install maven—— 官方源的maven包通常滞后 2~3 个大版本，且依赖 OpenJDK 11，和你本地 JDK 17/21 可能冲突 - CentOS/RHEL 8+ 用户注意：
dnf install maven装的是maven-local，它不提供mvn全局命令，而是用于构建 RPM 包的内部工具，不是你要的 Apache Maven
用 SDKMAN! 安装并管理多个 Maven 版本
这是最省心、最贴近 Java 开发者真实工作流的方式。SDKMAN! 不仅能装 maven，还能同时共存 maven 3.8.8、3.9.6、4.0.0-alpha-5，并一键切换，避免项目间因 Maven 版本差异导致的 Could not resolve dependencies 或 Unknown lifecycle phase "package" 错误。
实操建议：
- 运行
curl -s "https://get.sdkman.io" | bash，然后source "$HOME/.sdkman/bin/sdkman-init.sh" - 执行
sdk list maven查看可用版本（带*的是推荐稳定版，如3.9.6） - 装指定版本：
sdk install maven 3.9.6，之后mvn -v就能确认生效 - 若需临时切版本（比如调试老项目），用
sdk use maven 3.8.8，退出终端即恢复默认
手动解压安装（适合离线/受限环境）
当无法联网或公司内网禁止外部包管理器时，这是唯一可靠方式。关键不是“下载完解压就行”，而是路径、权限和环境变量三者必须对齐，否则 mvn 找不到 tools.jar 或报 JAVA_HOME not set（即使 java -version 正常）。
实操建议：
- 从 Maven 官网 下载
apache-maven-3.9.6-bin.tar.gz（别下-src或-zip） - 解压到非用户主目录的统一位置，例如
/opt/maven：sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt/ && sudo ln -sf /opt/apache-maven-3.9.6 /opt/maven - 在
/etc/profile.d/maven.sh中写入：export MAVEN_HOME=/opt/maven<br>export PATH=$MAVEN_HOME/bin:$PATH
，然后source /etc/profile.d/maven.sh - 验证：运行
mvn -v，输出中Maven home必须显示/opt/maven，且Java version和你$JAVA_HOME一致
配置 settings.xml 避免首次构建卡住
刚装好的 Maven 第一次跑 mvn clean compile 会卡在 Downloading from central，不是网络慢，而是默认中央仓库（https://repo.maven.apache.org/maven2/）在国内直连极慢，且没配镜像源。更隐蔽的问题是：如果你用 IDE（如 IntelliJ）导入项目，它可能读取的是 ~/.m2/settings.xml，而命令行用的是 $MAVEN_HOME/conf/settings.xml，两者不一致会导致依赖解析行为不一致。
实操建议：
- 优先修改全局配置：
sudo cp $MAVEN_HOME/conf/settings.xml /opt/maven/conf/settings.xml，再编辑该文件，在<mirrors>标签下插入阿里云镜像：
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
- 确认
~/.m2/settings.xml不存在，或软链到全局配置：ln -sf /opt/maven/conf/settings.xml ~/.m2/settings.xml - 删掉
~/.m2/repository（第一次配置后可选），让 Maven 重新拉取索引和依赖，验证是否提速
echo $JAVA_HOME 和 mvn -v 对齐，比重装十遍都管用。 
