Java Maven更换国内源

十分想念顺店杂可。。。

在使用 Maven 时,默认仓库位于国外,下载依赖速度较慢,更换为国内源(如阿里云、华为云等)可显著提升效率。以下是更换国内源的详细步骤:

一、找到 Maven 配置文件

Maven 的仓库配置通过 settings.xml 文件管理,有两个可能的位置:

  1. 用户级配置 (推荐):${用户目录}/.m2/settings.xml

    (Windows 通常为 C:\Users\用户名\.m2\settings.xml;Linux/Mac 为 ~/.m2/settings.xml

  2. 全局配置${Maven安装目录}/conf/settings.xml

    (如 D:\apache-maven-3.8.6\conf\settings.xml

注意:若 ~/.m2 目录下没有 settings.xml,可从 Maven 安装目录的 conf 文件夹中复制一份到该目录,或直接创建新文件。

二、配置国内镜像源

settings.xml 中找到或添加 <mirrors> 节点,配置国内镜像(以阿里云为例,最常用且稳定):

XML 复制代码
<settings>
  <!-- 其他配置... -->
  <mirrors>
    <!-- 阿里云公共仓库 -->
    <mirror>
      <id>aliyunmaven</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>*</mirrorOf> <!-- 匹配所有仓库 -->
    </mirror>

    <!-- 可选:阿里云其他仓库(如Spring仓库) -->
    <mirror>
      <id>aliyun-spring</id>
      <name>阿里云Spring仓库</name>
      <url>https://maven.aliyun.com/repository/spring</url>
      <mirrorOf>spring</mirrorOf>
    </mirror>
  </mirrors>
  <!-- 其他配置... -->
</settings>

三、关键配置说明

  • <id>:镜像唯一标识(自定义,不重复即可)。
  • <name>:镜像名称(描述性文字)。
  • <url>:国内仓库地址(阿里云公共仓库地址为 https://maven.aliyun.com/repository/public)。
  • <mirrorOf>:指定镜像匹配的仓库 ID,* 表示匹配所有中央仓库,优先级最高。

四、其他国内源(可选)

若阿里云源不稳定,可替换为其他源:

  1. 华为云

    XML 复制代码
    <mirror>
      <id>huaweicloud</id>
      <name>华为云公共仓库</name>
      <url>https://repo.huaweicloud.com/repository/maven/</url>
      <mirrorOf>*</mirrorOf>
    </mirror>
  2. 腾讯云

    XML 复制代码
    <mirror>
      <id>tencent</id>
      <name>腾讯云公共仓库</name>
      <url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
      <mirrorOf>*</mirrorOf>
    </mirror>

五、生效验证

配置完成后,可通过以下方式验证:

  1. 执行 Maven 命令(如 mvn clean install),观察控制台输出的依赖下载地址,确认是否为国内源 URL。
  2. 若使用 IDE(如 IDEA、Eclipse),需确保 IDE 已关联正确的 Maven 配置(在 IDE 偏好设置中检查 Maven -> User Settings File 路径是否正确)。

注意事项

  • 若项目中使用了私有仓库,需避免 <mirrorOf>*</mirrorOf> 覆盖私有仓库,可将 <mirrorOf> 改为 central(仅覆盖中央仓库)。
  • 定期检查国内源的可用性,部分源可能会调整 URL。

通过更换国内源,Maven 依赖下载速度可提升数倍,显著改善开发效率。

相关推荐
爱吃土豆的马铃薯ㅤㅤㅤㅤㅤㅤㅤㅤㅤ12 小时前
通过java后端代码来实现给word内容补充格式文本内容控件,以及 设置控件的标记和标题
java·c#·word
無限進步D13 小时前
Java 面向对象高级 接口
java·开发语言
逸Y 仙X14 小时前
文章二十七:ElasticSearch ES查询模板(Search Template)高效复用实战
java·大数据·数据库·elasticsearch·搜索引擎·全文检索
二哈赛车手14 小时前
新人笔记---Spring AI的Advisor以及其底层机制讲解(涉及源码),包含一些遇见的Spring AI的Advisor缺陷问题的解决方案
java·人工智能·spring boot·笔记·spring
薪火铺子14 小时前
Redis 缓存三大问题与解决方案
redis·spring·缓存
AC赳赳老秦14 小时前
接口测试自动化:用 OpenClaw 对接 Postman,实现批量回归测试、测试报告自动生成与推送
java·人工智能·python·算法·elasticsearch·deepseek·openclaw
两年半的个人练习生^_^14 小时前
Java日志框架和使用、日志记录规范
java·开发语言·开发规范
pq21715 小时前
最简单的理解synchronized锁升级
java
杨凯凡15 小时前
【032】排查入门:jstack、heap dump、Arthas 初识
java·开发语言·后端