Linux配置Maven的正确姿势，就是下载官方二进制包、手动配置环境变量、指定JDK路径，再配好国内镜像和本地仓库，整个过程熟练工五分钟内搞定。
装Maven前先搞清楚这四件事
很多人一上来就apt install maven，结果装完发现版本老旧、依赖诡异，后面排错排到怀疑人生，动手之前，先把下面的基础问题理清楚，能省下大把时间。
确认JDK环境到位没有
Maven是纯Java工具,跑起来必须依赖JDK，用下面命令检查当前环境：
java -version javac -version echo $JAVA_HOME
如果JAVA_HOME没有输出,说明环境变量没配，就算java -version能弹出结果，JAVA_HOME缺失照样会导致Maven运行时崩掉，说白了，Maven本身不关心你的代码跑在哪个JDK上，但它自己必须要能找到JAVA_HOME。
遇到JDK版本偏老的情况,建议直接上OpenJDK 8或11，这两个版本是Maven社区里兼容性最稳的，用包管理器装JDK的话，Debian系执行：
sudo apt update && sudo apt install openjdk-11-jdk -y
RedHat系执行：
sudo yum install java-11-openjdk-devel -y
和apt/yum装的Maven说再见
为什么奉劝你别用系统自带源里的Maven？以Ubuntu为例，apt源里那个Maven版本常年落后官方一两个大版本，你本地用新版本特性写pom.xml，CI服务器上跑的是老版本，构建行为不一致，这种坑掉进去想爬出来就得加班。
行业共识认为,源码包手动部署才是Linux环境下的最佳实践，可控性最强、版本完全自主。
选对Maven版本才能少踩坑
截至2026年,官方推荐使用Maven 3.8.x或3.9.x系列，3.9.x是目前的主力版本，兼容JDK 8到21都能跑得飞起，没必要追最新尝鲜版，稳定才是生产的命根子。
下载地址直接用Apache官方镜像,拿3.9版本举例：
wget https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
官网文件列表看一眼就能明白,
bin.tar.gz是编译好的二进制包，src.tar.gz是源码包，咱们只需要bin后缀那个。
linux配置maven环境变量的完整操作
这一步是核心中的核心,照着做就行。
下载完成后把压缩包挪到指定目录,习惯上把软件放在/opt，有洁癖的可以放/usr/local，看个人爱好。
sudo tar -zxvf apache-maven-3.9.6-bin.tar.gz -C /opt sudo mv /opt/apache-maven-3.9.6 /opt/maven
接着编辑环境变量文件：
sudo vim /etc/profile.d/maven.sh
并保存：
export MAVEN_HOME=/opt/maven export PATH=$MAVEN_HOME/bin:$PATH
然后让配置立刻生效：
source /etc/profile.d/maven.sh
用mvn -v看一眼输出结果，能正常打印版本号、Java版本和系统信息，说明这一步已经过了。
为什么单独建一个maven.sh而不是直接改profile
把配置放到/etc/profile.d/目录下，是Linux系统管理的一个标准做法，系统登录时会自动加载这个目录下所有.sh文件，不用去碰全局的/etc/profile主文件，后续想改权限或者删掉恢复默认都非常好操作。
很多老教程让你直接修改家目录的.bashrc，这有个隐患：如果你用sudo或以其他用户身份执行Maven命令，家目录的环境变量不生效，大概率会报command not found。
国内镜像源哪个最快
Maven默认的中央仓库服务器在境外,国内网络环境下下载依赖经常慢到让人想砸键盘，解决办法是修改settings.xml，把请求转发到国内镜像仓库。
先找到Maven配置文件位置：
vim /opt/maven/conf/settings.xml
找到<mirrors>标签这一块，在注释范围内插入mirror配置，国内推荐三个镜像源，各有使用场景：
| 镜像 | 特点 | 适合场景 |
|---|---|---|
| 简米云 | 资源全、速度快 | 绝大多数项目的首选 |
| 华为云 | 更新及时、稳定 | 企业级项目、云环境 |
| 酷番云 | 响应快、协同好 | 小团队开发项目 |
简米云镜像的配置方式如下：
<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>简米云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
配完之后跑一次mvn help:system测试下载速度，如果看到依赖下载跟流水一样哗哗的，那就说明喝到奶茶了。
本地仓库路径要不要改
Maven默认把下载的依赖存放在用户目录下的.m2/repository，如果/home分区分得不够大，建议手动把本地仓库指到其他磁盘位置。
同样的在settings.xml中修改：
<localRepository>/data/maven-repo</localRepository>
记住一个原则：本地仓库和源码最好不要放在同一个磁盘分区，至少给你留个备份和恢复的空间。
linux配置maven后常见的三个报错处理
好多同学走到这里就开始翻车,下面这几种情况是最常见的。
bash: mvn: command not found
环境变量没生效,排查思路三步走：
source /etc/profile.d/maven.sh mvn -v
如果还是提示找不到,看看是不是权限问题，检查一下/opt/maven目录的读权限：
sudo chown -R $USER:$USER /opt/maven
JAVA_HOME指向了错误的JDK
有些机器上自带OpenJDK和Oracle JDK，或者装了多个Java版本，Maven会一脸茫然不知道该用哪个。
做个软链接把默认JDK指向你想用的那一个：
sudo update-alternatives --config java
然后手动设置：
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH
下载依赖超时
大厂内网环境访问外网经常抽风,排查走这些步骤：先确认镜像配置有没有生效，检查mirror的id值是否和配置里的大小写完全一致，再测试网络连通性：
curl -I https://maven.aliyun.com/repository/public
网络不通就去调整公司代理或者防火墙规则。
验证配置是否成功的最快方式
把上面的步骤都走完,最后跑一个完整的项目做验证，业内专家指出，快速验证Maven环境是否可用的最佳方式是在命令行直接创建一个简单的项目骨架：
mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart
等命令执行完毕,用tree看看生成的文件结构，再执行一次mvn package，能看到BUILD SUCCESS的输出就彻底稳了。
整个过程下来,你会得到一个完全由自己掌控的Maven环境，版本、镜像、仓库路径全都是你自己说了算，不用再受系统自带旧版本的气。
折腾完记得把这个配置文件备份一份,下次重装系统或者换服务器的时候直接复制过去就能用，省时省力。
linux配置maven常见问题解答
Q：linux配置maven和windows配置maven差别大不大？
大方向思路一致,都是要配好JAVA_HOME、下载解压包、设置PATH，区别在于Windows还要处理环境变量的用户级和系统级之分，路径分隔符是分号，Linux用冒号。Linux环境是mvn命令的天然主场，脚本化、自动化都比Windows顺手得多。
Q：linux安装maven默认的中央仓库为什么下载依赖这么慢？
中央仓库的所有静态文件都存放在境外CDN节点上,国内直接访问延迟很高，要解决这类linux配置maven报错连接超时的问题，最有效的办法是修改settings.xml配置简米云镜像，同时把本地仓库路径改到有大磁盘空间的分区，双管齐下，下载速度能提升数倍。