Maven无法运行的根本原因是Java环境未正确配置：必须安装JDK 8+（推荐17+），JAVA_HOME需指向JDK根目录且不能含中文/空格，javac -version需有输出；M2_HOME需指向Maven解压根目录，并将对应bin路径加入PATH；首次运行会下载依赖，国内用户须提前配置~/.m2/settings.xml镜像。
Java环境没配好，Maven根本跑不起来
Maven不是独立运行的工具，它依赖 JAVA_HOME 指向一个可用的 JDK（必须是 JDK 8 或更高版本，JDK 17+ 更推荐），且 java -version 命令必须能正常输出。常见错误是只装了 JRE、或 JAVA_HOME 指向了 JRE 目录、或路径含中文/空格——这些都会导致 mvn -v 报错 Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher。
- 检查 JDK 安装：运行
javac -version，有输出才算真正装好了 JDK -
JAVA_HOME必须是 JDK 根目录（如C:\Program Files\Java\jdk-17.0.1或/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home），不能带\bin - Windows 下建议用系统变量设置
JAVA_HOME，Linux/macOS 在~/.zshrc或~/.bash_profile中写export JAVA_HOME=/path/to/jdk并执行source
下载 Maven 后别直接解压就用
官方二进制包（apache-maven-3.9.6-bin.zip）解压后，bin 目录下没有可执行文件，只有 mvn（Linux/macOS）和 mvn.cmd（Windows）——它们是启动脚本，不是编译产物。关键在于确保 M2_HOME（或 MAVEN_HOME）环境变量指向解压根目录，并把 %M2_HOME%\bin（Windows）或 $M2_HOME/bin（macOS/Linux）加入 PATH。
- Windows 推荐用
M2_HOME（Maven 官方文档指定），避免与旧脚本冲突 - 验证是否生效：终端新开一个窗口，运行
echo %M2_HOME%（Windows）或echo $M2_HOME（macOS/Linux），再运行mvn -v - 如果报
mvn: command not found，大概率是 PATH 没刷新或写错了路径（比如漏了\bin）
首次运行 mvn 会卡住，不是挂了是正在下载
执行 mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false 这类命令时，Maven 会自动从中央仓库拉取 maven-archetype-plugin 及其依赖，首次可能耗时 2–5 分钟（取决于网络），终端看起来“卡死”，其实是后台在下载 ~/.m2/repository/org/apache/maven/plugins/ 下一堆 JAR。
- 不要中断，更不要反复重试——重复执行会触发多次并发下载，反而更慢
- 若超时失败，检查
~/.m2/settings.xml是否配置了可用镜像（如阿里云：https://maven.aliyun.com/repository/public） - 国内用户强烈建议提前配好
settings.xml，否则连mvn -v都可能因校验远程插件元数据而卡住
settings.xml 放错位置等于没配
Maven 加载 settings.xml 的优先级是：命令行参数 -s > 用户目录 ~/.m2/settings.xml > Maven 安装目录 $M2_HOME/conf/settings.xml。绝大多数人想改的是用户级配置（比如镜像、本地仓库路径），但常误把文件丢进 $M2_HOME/conf/ ——这个位置只影响当前 Maven 安装，换台机器或重装就失效；而 ~/.m2/settings.xml 才是绑定用户身份的持久配置。
立即学习“Java免费学习笔记（深入）”；
- Windows 用户注意：
~对应C:\Users\用户名\.m2\，不是Desktop或Documents - 如果
~/.m2不存在，运行任意mvn命令一次就会自动生成该目录 - 修改后无需重启终端，但已运行的 IDE（如 IntelliJ）可能要刷新 Maven 项目或重启才能识别新镜像
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
</settings>
Maven 看似简单，但每个环节都依赖前序步骤的精确性：JDK 路径错一格、环境变量名打错字母、settings.xml 放错层级，都会让后续所有操作陷入不可预测的失败。最稳妥的做法是每设一个变量，立刻新开终端验证——别信“应该没问题”。 
