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 依赖下载速度可提升数倍,显著改善开发效率。

相关推荐
桦说编程2 小时前
从 ForkJoinPool 的 Compensate 看并发框架的线程补偿思想
java·后端·源码阅读
躺平大鹅4 小时前
Java面向对象入门(类与对象,新手秒懂)
java
初次攀爬者4 小时前
RocketMQ在Spring Boot上的基础使用
java·spring boot·rocketmq
花花无缺5 小时前
搞懂@Autowired 与@Resuorce
java·spring boot·后端
Derek_Smart6 小时前
从一次 OOM 事故说起:打造生产级的 JVM 健康检查组件
java·jvm·spring boot
NE_STOP7 小时前
MyBatis-mybatis入门与增删改查
java
孟陬10 小时前
国外技术周刊 #1:Paul Graham 重新分享最受欢迎的文章《创作者的品味》、本周被划线最多 YouTube《如何在 19 分钟内学会 AI》、为何我不
java·前端·后端
想用offer打牌10 小时前
一站式了解四种限流算法
java·后端·go
华仔啊11 小时前
Java 开发千万别给布尔变量加 is 前缀!很容易背锅
java