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

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

---

一、为什么要切换镜像源

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

---

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

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

🔒 点击解锁完整内容

在国内开发环境中，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 构建更顺畅。

🔒 关注公众号，解锁完整内容

扫码关注「程序进阶之路」，关注后自动获取验证码

微信扫码 → 关注公众号

📌 关注「程序进阶之路」公众号

💬 关注后自动收到验证码

🔑 将收到的验证码填到下方

立即解锁

关注后可获取：📦 300+ 篇文章归档 · 📨 每周精选推送 · 💬 技术交流群