在 Linux 环境下配置 Maven 开发环境，尤其是设置仓库镜像以加速依赖下载，是 Java 开发者必须掌握的基础技能。不过实际动手时，很多人会被环境变量配置、配置文件优先级或缓存问题困扰。今天我们就来完整拆解整个过程，确保你一次就能配置成功。
确认系统已安装 JDK 并配置好 JAVA_HOME
这是第一步，也是最关键的一步。Maven 3.9+ 版本要求 JDK 11 或更高版本。如果系统中的 Java 版本不满足要求，或者环境变量没有正确设置，Maven 启动就会直接报错，典型的错误信息是：ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
如何检查呢？打开终端，依次执行两条命令：
echo $JAVA_HOME which java
第一条命令应该输出 JDK 的安装路径，例如 /usr/lib/jvm/java-17-openjdk-amd64；第二条命令则应返回 Java 可执行文件的具体位置。如果两者有任何一项没有结果，就需要手动配置。
配置方法并不复杂。编辑当前用户的 ~/.bashrc 文件（如果想全局生效，可以编辑 /etc/profile），在文件末尾追加类似下面的两行（请根据你实际的 JDK 安装路径修改）：
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH
保存后，执行 source ~/.bashrc 让配置立即生效。最后，再用 java -version && echo $JAVA_HOME 验证一下，确保版本和路径都正确无误。
下载解压 Maven 并配置 M2_HOME 和 PATH
接下来是安装 Maven。这里有一个小建议：尽量不要使用系统自带的包管理器安装，例如 apt install maven。原因很简单，像 Ubuntu 或 Debian 这类发行版的官方源，里面的 Maven 版本通常比较滞后，可能还是 3.6.x，而且默认不会设置 M2_HOME 环境变量，后续你想调整本地仓库路径或修改配置时会比较麻烦。
更推荐的做法是，直接从 Apache 官网下载最新的二进制包。例如，目前稳定版是 3.9.7，你可以用 wget 命令下载：
wget https://dlcdn.apache.org/maven/maven-3/3.9.7/binaries/apache-maven-3.9.7-bin.tar.gz
下载完成后，把它解压到一个固定的、有权限的目录，比如 /opt/：
sudo tar -xzf apache-maven-3.9.7-bin.tar.gz -C /opt/
解压后会得到 /opt/apache-maven-3.9.7 这个目录，这就是你的 Maven 安装目录。
然后，同样需要配置环境变量。打开 ~/.bashrc 文件，添加以下两行：
export M2_HOME=/opt/apache-maven-3.9.7 export PATH=$M2_HOME/bin:$PATH
保存并执行 source ~/.bashrc 重载配置。最后，在终端输入 mvn -v，如果能看到 Maven 和 Java 的版本信息，恭喜你，安装成功了。
修改 settings.xml 配置阿里云镜像加速
安装好 Maven 只是开始，让它“飞起来”的关键在于配置镜像。默认的中央仓库在国外，下载依赖速度令人担忧。换成国内镜像，比如阿里云的 Maven 仓库，体验会好很多。
Maven 的配置文件是 settings.xml。它有两个位置：全局配置（$M2_HOME/conf/settings.xml）和用户级配置（~/.m2/settings.xml）。用户级配置的优先级更高，且只影响当前用户，更安全。因此，我们通常直接修改用户目录下的这个文件。如果 ~/.m2/settings.xml 不存在，可以从全局配置复制一份过来。
配置镜像的核心，是修改 central，这样才能确保像 Spring 插件库这类非中央仓库的请求也能被加速。
打开 ~/.m2/settings.xml，在
aliyunmaven * Aliyun Maven https://maven.aliyun.com/repository/public
注意看 central，那么像 spring-snapshots 这样的特殊仓库依然会走官方的慢速源。
改完后，可以执行一个命令来测试，比如 mvn clean compile -U（-U 参数会强制更新快照依赖）。观察命令执行的日志，如果下载链接都变成了 maven.aliyun.com，说明镜像配置生效了。
验证本地仓库路径和镜像是否生效
到了最后一步，也是问题最多的一步：验证。很多人明明改了配置，却发现依赖还是从 repo.maven.apache.org 下载。问题可能出在哪儿？
首先，可能是环境变量没加载。修改 .bashrc 后，你重启终端了吗？或者执行 source 命令了吗？
其次，可能是配置文件放错了位置，或者存在多个配置文件互相覆盖。Maven 的配置加载是有优先级的，项目根目录下的 .mvn/wrapper/maven-wrapper.properties 或者 pom.xml 中的特定配置都可能覆盖用户级的 settings.xml。
怎么排查？Maven 提供了一个非常实用的命令：
mvn help:effective-settings
这个命令会打印出最终生效的所有配置。你可以用它来检查两个关键信息：
- 生效的配置文件路径：执行
mvn help:effective-settings | grep "Effective user-specific configuration"，看看它读的是不是你刚修改的那个settings.xml。 - 本地仓库的真实路径：执行
mvn help:effective-settings | grep localRepository。默认是~/.m2/repository，但你也可以在settings.xml里通过/data/m2
如果怀疑是旧缓存导致的问题，可以尝试清空部分缓存再测试。例如，删除 Maven 自身的依赖缓存：
rm -rf ~/.m2/repository/org/apache/maven
然后，运行一个简单的创建项目命令来触发下载：
mvn archetype:generate -DgroupId=test -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
仔细观察下载过程中的域名，就能确认镜像是否真正起效了。
说到底，镜像配置本身的代码很简单，真正让人卡住的，往往是路径没对上、配置没加载、或者多个配置层级互相覆盖这些“细节”。所以，动手修改前，先用 mvn help:effective-settings 看一眼当前生效的配置，往往比盲目修改文件要高效得多。
