快捷導(dǎo)航

Ubuntu 26.04 快速安裝Maven并配置阿里云鏡像

更新時(shí)間：2026年07月14日 09:45:39 作者：Moshow鄭鍇

本文介紹了在Ubuntu26.04上快速配置Maven開發(fā)環(huán)境的方法并設(shè)置阿里云鏡像,大幅加速依賴下載,告別慢速卡頓,感興趣的可以了解一下

一、安裝 Maven

Ubuntu 26.04 的官方軟件源中已經(jīng)包含了 Maven，通過 apt 命令即可一鍵安裝：

# 更新軟件包索引
sudo apt update
# 安裝 Maven
sudo apt install maven -y

安裝完成后，使用以下命令驗(yàn)證是否安裝成功：

mvn -v

如果看到 Maven 的版本信息（如 Apache Maven 3.x.x），說明安裝成功。

二、配置阿里云鏡像

Maven 默認(rèn)從中央倉庫下載依賴，速度較慢且容易出錯(cuò)。配置阿里云鏡像可以顯著提升下載速度。

1. 找到配置文件

Maven 的配置文件有兩個(gè)位置：

全局配置（影響所有用戶）：/usr/share/maven/conf/settings.xml
用戶配置（僅影響當(dāng)前用戶，推薦）：~/.m2/settings.xml

推薦使用用戶級配置，避免影響系統(tǒng)其他用戶。首先創(chuàng)建 .m2 目錄：

mkdir -p ~/.m2

2. 創(chuàng)建或編輯 settings.xml

用文本編輯器打開 ~/.m2/settings.xml：

nano ~/.m2/settings.xml

將以下內(nèi)容粘貼到文件中：

<?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 等多個(gè)倉庫。

保存并退出（nano 中按 Ctrl+X，然后按 Y 確認(rèn)保存）。

3. 驗(yàn)證配置

執(zhí)行以下命令，查看 Maven 是否能夠正常解析依賴：

mvn help:effective-settings

在輸出的 <mirrors> 部分中，如果能看到阿里云的鏡像配置，說明配置成功。

三、（可選）配置系統(tǒng)軟件源

如果你的 Ubuntu 26.04 系統(tǒng)軟件源下載速度也很慢，可以一并更換為阿里云鏡像。

?? 重要提示：Ubuntu 24.04 及以上版本已棄用傳統(tǒng)的 /etc/apt/sources.list 格式，改用 DEB822 格式的配置文件。配置文件位于 /etc/apt/sources.list.d/ubuntu.sources。

使用一鍵命令完成換源：

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 的輸出中出現(xiàn) mirrors.aliyun.com，說明換源成功。

總結(jié)

步驟	命令/操作	說明
安裝 Maven	sudo apt install maven -y	一行命令完成安裝
創(chuàng)建配置目錄	mkdir -p ~/.m2	創(chuàng)建用戶級 Maven 配置目錄
配置阿里云鏡像	編輯 ~/.m2/settings.xml	添加 mirror 配置
驗(yàn)證安裝	mvn -v	檢查 Maven 版本
驗(yàn)證鏡像	mvn help:effective-settings	確認(rèn)鏡像配置生效