Maven 切换阿里云镜像源，提升依赖下载速度

在国内开发环境中，Maven 默认中央仓库下载慢，经常报超时或下载失败。本文教你如何快速切换到阿里云镜像源，让依赖下载更稳定、更快。

---

一、为什么要切换镜像源

• Maven 默认仓库在国外，访问速度慢
• CI/CD 构建频繁依赖下载容易失败
• 使用阿里云镜像源即可解决速度和稳定性问题

---

二、切换方式一：修改全局 settings.xml（推荐）

1. 找到 Maven 配置文件 settings.xml：
   • Windows: C:\Users\你的用户名\.m2\settings.xml
   • Linux/macOS: ~/.m2/settings.xml
2. 在 <mirrors> 标签中添加阿里云镜像：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

1. 保存文件，重新构建项目即可。

⚠️ 注意：修改全局配置会影响本机所有 Maven 项目。

在国内开发环境中，Maven 默认中央仓库下载慢，经常报超时或下载失败。本文教你如何快速切换到阿里云镜像源，让依赖下载更稳定、更快。

---

一、为什么要切换镜像源

• Maven 默认仓库在国外，访问速度慢
• CI/CD 构建频繁依赖下载容易失败
• 使用阿里云镜像源即可解决速度和稳定性问题

---

二、切换方式一：修改全局 settings.xml（推荐）

1. 找到 Maven 配置文件 settings.xml：
   • Windows: C:\Users\你的用户名\.m2\settings.xml
   • Linux/macOS: ~/.m2/settings.xml
2. 在 <mirrors> 标签中添加阿里云镜像：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

1. 保存文件，重新构建项目即可。

⚠️ 注意：修改全局配置会影响本机所有 Maven 项目。

---

三、切换方式二：仅修改单个项目

1. 在项目根目录创建或编辑 pom.xml
2. 在 <repositories> 标签中添加：

<repository>
    <id>aliyun-public</id>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</repository>

1. 保存后，项目构建将使用阿里云镜像源。

---

四、切换后验证

mvn clean install

• 如果依赖下载速度明显提升，说明配置成功
• 若仍慢，可检查网络或防火墙设置

---

总结：
修改全局 settings.xml 是最简单、最推荐的方法。单项目配置适合临时需求。切换阿里云镜像源后，Maven 下载依赖更稳定，CI/CD 构建更顺畅。

  查看全文

首次访问，人机识别

扫描下方二维码回复 程序员 获取解锁验证码

步骤：[ 打开微信 ]->[ 扫描上方二维码 ]->[ 关注 程序进阶之路 的公众号] 输入 程序员 获取验证码，即可解锁文章。

验证码：

确定