Ubuntu 20.04/22.04 安装 Maven 超详细教程（含环境配置 + 阿里云镜像加速）

12次阅读

没有评论

在 Java 后端开发中，Maven 是必不可少的项目构建与依赖管理工具，它能帮我们自动管理 jar 包、编译项目、打包部署，极大提升开发效率。

本文针对 Ubuntu 20.04/22.04 LTS 系统，提供两种安装方式（APT 快速安装 / 手动指定版本安装），手把手完成 Maven 安装、环境变量配置、国内镜像加速，新手也能一步到位搞定！

一、环境说明

操作系统：Ubuntu 20.04 / 22.04（长期支持版，服务器 / 本地通用）
Maven 版本：3.9.6（官方最新稳定版）
前置依赖：Maven 基于 Java 运行，必须先安装 JDK！

二、前置准备：安装 Java JDK

执行以下命令安装 OpenJDK 11（企业最常用的稳定版本）：

bash

运行

# 更新软件源
sudo apt update
# 安装 JDK11
sudo apt install openjdk-11-jdk -y

安装完成后，验证 Java 环境：

bash

运行

java -version

出现版本信息，说明 JDK 安装成功 ✅

三、安装方式二选一

方式 1：APT 一键安装（简单快捷，适合新手）

Ubuntu 官方软件源自带 Maven，无需手动配置，一行命令即可安装：

bash

运行

# 安装 maven
sudo apt install maven -y

安装完成后，直接验证版本：

bash

运行

mvn -v

✅ 优点：操作最简单，无需配置环境变量

❌ 缺点：软件源中的 Maven 版本固定，无法安装最新版

方式 2：手动安装指定版本（推荐！灵活可控）

如果需要最新版 / 指定版本的 Maven，手动安装是最佳选择，步骤如下：

1. 下载 Maven 二进制包

进入官方下载目录，用 wget 下载最新稳定版（这里以 3.9.6 为例）：

bash

运行

# 进入临时下载目录
cd /tmp
# 下载 Maven 3.9.6
wget https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz

2. 解压到系统标准目录

Linux 惯例将软件安装在 /usr/local/ 目录下：

bash

运行

# 创建 maven 安装目录
sudo mkdir -p /usr/local/maven
# 解压下载的压缩包
sudo tar -zxvf apache-maven-3.9.6-bin.tar.gz -C /usr/local/maven/

3. 配置全局环境变量

编辑系统环境变量文件，让 Maven 命令全局生效：

bash

运行

# 编辑 profile 配置文件
sudo nano /etc/profile

在文件末尾添加以下配置：

bash

运行

# Maven 环境变量配置
export M2_HOME=/usr/local/maven/apache-maven-3.9.6
export PATH=$PATH:$M2_HOME/bin

按 Ctrl+O 保存
按 Ctrl+X 退出编辑器

4. 生效环境变量并验证

bash

运行

# 刷新环境变量，立即生效
source /etc/profile
# 验证 Maven 版本
mvn -v

出现版本、Java 版本信息，说明手动安装成功 ✅

四、必做优化：配置阿里云镜像加速

Maven 默认从国外中央仓库下载依赖，速度极慢！配置阿里云镜像能提升下载速度 10 倍以上。

1. 找到 Maven 配置文件

APT 安装：配置文件路径 /etc/maven/settings.xml
手动安装：配置文件路径 /usr/local/maven/apache-maven-3.9.6/conf/settings.xml

编辑配置文件：

bash

运行

# 手动安装执行此命令
sudo nano /usr/local/maven/apache-maven-3.9.6/conf/settings.xml

# APT安装执行此命令
# sudo nano /etc/maven/settings.xml

2. 添加阿里云镜像

找到 <mirrors> 标签，在标签内添加以下镜像配置：

xml

<mirror>
  <id>aliyunmaven</id>
  <name>阿里云中央仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>central</mirrorOf>
</mirror>

保存退出，镜像配置完成！

五、Maven 常用基础命令

安装完成后，这些日常开发命令直接用：

bash

运行

# 编译项目
mvn compile
# 清理编译文件
mvn clean
# 打包项目（生成jar/war包）
mvn package
# 安装项目到本地仓库
mvn install
# 跳过测试代码打包
mvn package -DskipTests

六、卸载 Maven

卸载 APT 安装的 Maven

bash

运行

sudo apt remove maven -y
sudo apt autoremove -y

卸载手动安装的 Maven

bash

运行

# 删除安装目录
sudo rm -rf /usr/local/maven
# 删除环境变量配置（编辑/etc/profile，删除maven相关配置）
sudo nano /etc/profile
# 刷新环境变量
source /etc/profile

七、常见问题排查

报错 mvn: command not found原因：环境变量未配置 / 未生效解决：重新执行 source /etc/profile，检查环境变量路径是否正确
依赖下载依然很慢原因：镜像配置错误解决：检查 settings.xml 中阿里云镜像的标签是否正确
提示 JAVA_HOME 未配置原因：JDK 环境变量缺失解决：重新安装 JDK 或配置 JAVA_HOME 环境变量