在 Ubuntu 26.04 上配置 Maven 开发环境,只需几个简单的步骤就能完成。本文将带你快速完成 Maven 的安装,并配置阿里云镜像来加速依赖下载。
一、安装 Maven
Ubuntu 26.04 的官方软件源中已经包含了 Maven,通过 apt 命令即可一键安装:
# 更新软件包索引 sudo apt update # 安装 Maven sudo apt install maven -y
安装完成后,使用以下命令验证是否安装成功:
mvn -v
如果看到 Maven 的版本信息(如 Apache Maven 3.x.x),说明安装成功。
bash # ----------------------------------------------------- # - 🚀 Powered by Moshow郑锴 # - 🌟 Might the holy code be with you! # ----------------------------------------------------- # 🔍 公众号 👉 软件开发大百科 # 💻 CSDN 👉 https://zhengkai.blog.csdn.net # 📂 Github 👉 https://github.com/moshowgame
二、配置阿里云镜像
Maven 默认从中央仓库下载依赖,速度较慢且容易出错。配置阿里云镜像可以显著提升下载速度。
1. 找到配置文件
Maven 的配置文件有两个位置:
-
全局配置 (影响所有用户):
/usr/share/maven/conf/settings.xml -
用户配置 (仅影响当前用户,推荐):
~/.m2/settings.xml
推荐使用用户级配置,避免影响系统其他用户。首先创建 .m2 目录:
mkdir -p ~/.m2
2. 创建或编辑 settings.xml
用文本编辑器打开 ~/.m2/settings.xml:
nano ~/.m2/settings.xml
将以下内容粘贴到文件中:
XML
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
https://maven.apache.org/xsd/settings-1.0.0.xsd">
<mirrors>
<!-- 阿里云 Maven 镜像 -->
<mirror>
<id>aliyun-maven</id>
<mirrorOf>central</mirrorOf>
<name>阿里云 Maven 镜像</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>
</settings>
💡 提示 :也可以使用
https://maven.aliyun.com/repository/public作为镜像地址,它涵盖了 central、jcenter 等多个仓库。
保存并退出(nano 中按 Ctrl+X,然后按 Y 确认保存)。
3. 验证配置
执行以下命令,查看 Maven 是否能够正常解析依赖:
mvn help:effective-settings
在输出的 <mirrors> 部分中,如果能看到阿里云的镜像配置,说明配置成功。

三、(可选)配置系统软件源
如果你的 Ubuntu 26.04 系统软件源下载速度也很慢,可以一并更换为阿里云镜像。
⚠️ 重要提示 :Ubuntu 24.04 及以上版本已弃用传统的 /etc/apt/sources.list 格式,改用 DEB822 格式的配置文件。配置文件位于 /etc/apt/sources.list.d/ubuntu.sources。
使用一键命令完成换源:
bash
sudo sed -i 's|http://archive.ubuntu.com/ubuntu|https://mirrors.aliyun.com/ubuntu|g; s|http://security.ubuntu.com/ubuntu|https://mirrors.aliyun.com/ubuntu|g' /etc/apt/sources.list.d/ubuntu.sources
sudo apt update
如果 apt update 的输出中出现 mirrors.aliyun.com,说明换源成功。
总结
| 步骤 | 命令/操作 | 说明 |
|---|---|---|
| 安装 Maven | sudo apt install maven -y |
一行命令完成安装 |
| 创建配置目录 | mkdir -p ~/.m2 |
创建用户级 Maven 配置目录 |
| 配置阿里云镜像 | 编辑 ~/.m2/settings.xml |
添加 mirror 配置 |
| 验证安装 | mvn -v |
检查 Maven 版本 |
| 验证镜像 | mvn help:effective-settings |
确认镜像配置生效 |
完成以上步骤后,你的 Ubuntu 26.04 就拥有了一个高速的 Maven 开发环境,依赖下载速度将大幅提升!🚀
