linux中安装配置maven的核心步骤是:先确保jdk 8+已安装并正确设置java_home,再下载解压maven二进制包(如3.9.6),配置m2_home与path环境变量,最后通过mvn -v验证版本、java路径及环境生效。

Linux 中安装配置 Maven,核心是确保 Java 环境就绪、正确解压 Maven 包、设置环境变量并验证生效。整个过程不依赖图形界面,纯命令行操作,适合服务器和开发环境。
确认并安装 JDK(Maven 运行前提)
Maven 是用 Java 编写的,必须有 JDK 8 或更高版本。运行以下命令检查:
java -version 和 javac -version
若提示命令未找到或版本过低(如低于 1.8),需安装:
- Ubuntu/Debian 系统:
sudo apt update && sudo apt install openjdk-17-jdk - CentOS/RHEL/Rocky Linux:
sudo dnf install java-17-openjdk-devel(较新版本)
或 sudo yum install java-17-openjdk-devel(旧版)
安装后,建议显式设置 JAVA_HOME(路径以实际为准,可用 find /usr/lib/jvm -name "jdk-17*" 查找):
echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk' | sudo tee -a /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' | sudo tee -a /etc/profile
source /etc/profile
下载并解压 Maven
推荐使用清华镜像加速下载(稳定且快):
wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
解压到系统级目录(如 /opt):
sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt/
可选:创建软链接便于后续升级维护:
sudo ln -sf /opt/apache-maven-3.9.6 /opt/maven
配置 Maven 环境变量
编辑全局配置文件(所有用户生效):
sudo nano /etc/profile
在文件末尾添加:
export M2_HOME=/opt/maven
export MAVEN_HOME=$M2_HOME
export PATH=$PATH:$M2_HOME/bin
保存后立即加载:
source /etc/profile
⚠️ 注意:不要混用 MAVEN_HOME 和 M2_HOME 的定义方式;现代 Maven 推荐统一使用 M2_HOME,但两者设为同一路径即可兼容。
验证安装与基础检查
运行以下命令确认 Maven 可执行且识别 JDK:
mvn -v
正常输出应包含三部分:
- Maven 版本(如 Apache Maven 3.9.6)
- Java 版本(如 Java version: 17.0.1)
- JAVA_HOME 路径(应与你设置的一致)
如果报错 “command not found: mvn”,检查 PATH 是否拼写错误或未 source;
如果报错 “JAVA_HOME is not defined correctly”,说明 JAVA_HOME 路径不对或未导出。











