Linux安装Maven需先确认JDK 11+已就位，再解压至/opt/并配置M2_HOME与PATH到~/.bashrc；settings.xml优先放~/.m2/，配阿里云镜像及本地仓库路径，私服还需同步配置servers、mirrors和pom.xml的distributionManagement。
Linux 上装 Maven 本身不难，真正卡住人的地方是 settings.xml 配置错位、镜像没生效、本地仓库路径权限不对，或者私服认证被 silently 忽略——这些都不会报明确错误，只会让你等十几分钟然后发现依赖全从中央仓慢速下载。
怎么解压并设好 M2_HOME 和 PATH
别直接改 /etc/profile 全局配置，除非你确定所有用户都要用同一套 Maven。更稳妥的做法是写进当前用户的 ~/.bashrc 或 ~/.zshrc：
- 先确认 JDK 已就位：
java -version输出应含1.8+或11+，Maven 3.9+ 要求 JDK 11+ - 下载后解压（以 3.9.6 为例）：
tar -xzvf apache-maven-3.9.6-bin.tar.gz -C /opt/ - 编辑
~/.bashrc，追加两行：export M2_HOME=/opt/apache-maven-3.9.6export PATH=$M2_HOME/bin:$PATH - 执行
source ~/.bashrc，再跑mvn -v看输出里Maven home是否指向你刚设的路径
如果 mvn -v 报 command not found，八成是 PATH 拼写错了（比如写成 Path 或漏了 $），或 source 没执行。
settings.xml 放哪？改哪个？
Maven 会按顺序加载三处 settings.xml：Maven 安装目录下的 $M2_HOME/conf/settings.xml（全局）、用户目录下的 ~/.m2/settings.xml（推荐）、以及项目级的（不常用）。优先用用户级，避免污染全局配置：
- 首次运行
mvn clean后，~/.m2目录会自动生成；若没有，手动建：mkdir -p ~/.m2 - 把
$M2_HOME/conf/settings.xml复制一份到~/.m2/settings.xml：cp $M2_HOME/conf/settings.xml ~/.m2/ - 重点改两块：
— 取消注释并修改<localRepository>，比如设为/home/yourname/m2-repo（确保该路径存在且可写）
— 在<mirrors>下加阿里云镜像（国内最稳）：<mirror><br> <id>nexus-aliyun</id><br> <mirrorOf>central</mirrorOf><br> <name>Nexus aliyun</name><br> <url>https://maven.aliyun.com/repository/public</url><br></mirror>
注意：<mirrorOf>central</mirrorOf> 表示只代理中央仓库；若想代理全部远程仓（包括第三方插件库），得写 <mirrorOf>*</mirrorOf>，但某些私有插件可能因此拉不到。
连 Nexus 私服要填哪些关键项？
光配镜像不够，上传或拉取私有构件必须做三件事：声明镜像、声明服务器凭据、在 pom.xml 里指定分发仓库地址。缺一不可：
- 在
~/.m2/settings.xml的<servers>块里加账号（Nexus 默认 admin/admin123，但 Nexus 3 会生成随机初始密码，查cat /opt/sonatype-work/nexus3/admin.password）：<server><br> <id>nexus-releases</id><br> <username>admin</username><br> <password>{你的明文或加密密码}</password><br></server> - 在同一个
settings.xml的<mirrors>里加私服镜像（注意<id>必须和上面<server>的<id>一致）：<mirror><br> <id>nexus-releases</id><br> <mirrorOf>central</mirrorOf><br> <url>http://your-nexus-host:8081/repository/maven-releases/</url><br></mirror>
- 项目
pom.xml中必须声明<distributions>：<distributionManagement><br> <repository><br> <id>nexus-releases</id><br> <url>http://your-nexus-host:8081/repository/maven-releases/</url><br> </repository><br></distributionManagement>
最容易漏的是第三步：mvn deploy 时若没配 distributionManagement，Maven 根本不会尝试上传，也不会报错，只会默默把包留在本地仓库。
为什么 mvn clean install 还是从 central 下载？
不是镜像失效，而是你触发了“非 central 依赖”——比如用了 Spring Snapshot 仓库、JBoss 仓库，或者 pom.xml 里显式写了 <repository>。Maven 镜像只代理 <mirrorOf> 指定的仓库，其他仓库绕过镜像直连。
- 运行
mvn help:effective-settings确认最终生效的settings.xml路径和内容 - 加
-X参数看详细日志：mvn -X compile，搜索Downloading from，看它实际连的是哪个 URL - 如果看到
Downloading from central却没走阿里云地址，说明镜像配置的<id>和<mirrorOf>不匹配，或settings.xml加载顺序被覆盖（比如 IDE 自带 Maven 套件用了自己的配置）
私服调试最耗时间的从来不是安装，而是反复验证每层配置是否真的被读取、是否被覆盖、是否拼写一致——id 字符串大小写敏感，http 和 https 不能混用，Nexus 3 的 repository path 必须带末尾斜杠，这些细节错一个，整个链路就静默降级。
