不配 Maven 环境等于手动编译打包，mvn -v 报错因未配置 MAVEN_HOME 和 PATH；settings.xml 优先使用用户级 $HOME/.m2/settings.xml；IDE 需绑定外部 Maven 实例；调试构建失败应加 -e 参数或检查本地仓库权限与空间。
Java 项目里不配 Maven，等于写完代码还得手动找 javac、手动理 classpath、手动打包——能跑，但迟早崩溃。
下载 Maven 压缩包后为什么 mvn -v 报 “command not found”
根本原因：系统压根不知道 mvn 在哪。Maven 是纯 ZIP 包，不带安装器，解压完必须手动配置环境变量。
- 先解压到无中文、无空格路径，比如
/opt/maven（macOS/Linux）或C:\maven（Windows） - 设置
MAVEN_HOME指向解压根目录（不是bin子目录） - 把
$MAVEN_HOME/bin（Linux/macOS）或%MAVEN_HOME%\bin（Windows）追加进PATH - Windows 用户注意：
MAVEN_HOME必须用系统变量（非用户变量），否则 CMD/PowerShell 可能读不到
settings.xml 放哪？改哪个才生效
Maven 会按顺序加载三个 settings.xml：Maven 自带的（只读）、全局的（$MAVEN_HOME/conf/settings.xml）、用户的（$HOME/.m2/settings.xml）。优先级从低到高，**只有用户的那个能真正覆盖默认行为**。
- 首次配置镜像、本地仓库路径、认证信息，直接编辑
$HOME/.m2/settings.xml - 如果该文件不存在，就复制
$MAVEN_HOME/conf/settings.xml过来再改 - 别动
$MAVEN_HOME/conf/settings.xml—— 升级 Maven 时它会被覆盖 - 国内用户必加阿里云镜像，否则
mvn clean compile可能卡在下载org.apache.maven.plugins:maven-compiler-plugin
IDEA 或 Eclipse 里 Maven 不识别 pom.xml 怎么办
不是 Maven 装错了，是 IDE 没绑定对的 Maven 实例，或者项目没“刷新”成 Maven 项目。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ IDEA：File → Settings → Build → Build Tools → Maven → 把
Maven home path指向你解压的目录（不是bin）；然后右键pom.xml→ “Add as Maven Project” - Eclipse：Window → Preferences → Maven → Installations → Add → 选你的解压目录；之后 Import → Existing Maven Projects → 定位到含
pom.xml的文件夹 - 常见陷阱：IDE 自带嵌入式 Maven（
Bundled (Maven 3.x)），它用的是内置settings.xml，不会读你配的镜像和本地仓库
mvn clean install 失败但没报具体错，怎么快速定位
默认日志太简略，关键信息被吞了。得加参数看真实过程。
- 加
-X输出完整 debug 日志（慎用，信息爆炸） - 更实用的是加
-e：显示详细异常堆栈，尤其对PluginExecutionException类错误极有用 - 如果卡在某个依赖下载，先运行
mvn dependency:resolve -U强制更新快照依赖，看是否网络或镜像问题 - 检查
pom.xml里有没有写死不可达的私有仓库 URL，或缺失
最常被忽略的其实是 ~/.m2/repository 权限和磁盘空间——某次 mvn install 中断后残留锁文件，会导致后续所有构建静默失败，删掉 repository/.cache 和临时文件夹往往比重装 Maven 更快见效。
