2026-06-30 maven国内镜像配置（deepseek）

配置国内镜像，核心是修改 Maven 的 settings.xml 文件，在里面添加一个或多个国内的镜像源。下面是最直接的配置方法：

🔧 第一步：找到配置文件 settings.xml

• 用户级配置 (推荐)：在你的用户目录下，路径通常是 ~/.m2/settings.xml。如果文件不存在，可以从 Maven 安装目录复制一个过来。修改这个文件只影响当前用户，比较安全。
• 全局配置：Maven 安装目录下的 conf/settings.xml。修改后会影响这台机器上的所有用户，不推荐直接修改。

📝 第二步：添加国内镜像配置

用文本编辑器打开 settings.xml，在 <mirrors> 标签内添加以下代码。如果文件里没有 <mirrors> 标签，就手动创建一对。

以下是最常用的几个国内镜像配置，选择其一添加即可：

1. 阿里云镜像 (推荐，最稳定)

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

这是目前国内使用最广、最稳定的选择。

2. 华为云镜像

<mirror>
  <id>huaweicloud</id>
  <name>华为云Maven仓库</name>
  <url>https://repo.huaweicloud.com/repository/maven/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

对云服务依赖强的项目可以考虑这个。

3. 腾讯云镜像

<mirror>
  <id>tencent</id>
  <name>腾讯云镜像仓库</name>
  <url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

也是不错的稳定选择。

配置字段说明

• <mirrorOf>central</mirrorOf>：表示这个镜像会代替 Maven 官方的中央仓库。
• 如果希望这个镜像代理所有仓库请求，可以将 central 改为 *，但一般代理中央仓库就足够了。

✅ 第三步：验证配置

保存文件后，在命令行运行以下命令查看生效的配置，确认镜像地址正确：

mvn help:effective-settings

或者在执行 mvn clean compile 时，观察依赖下载的日志，如果看到下载地址是你配置的镜像 URL（比如 maven.aliyun.com），就说明配置成功了。

💡 进阶技巧

• 多镜像备用：可以配置多个镜像，当第一个不可用时，Maven 会尝试下一个。
• 指定私有仓库：对于企业内部私有仓库，可以通过 mirrorOf 配合 ! 排除特定仓库，保证内部依赖不受影响。