1. 背景

        在 Java 项目开发中,Maven 是最常用的依赖管理工具。由于网络环境限制,直接从 Maven 中央仓库下载依赖时常会遇到速度慢、连接超时等问题。通过配置国内镜像源,可以显著提升依赖下载速度,提高开发效率。

2. 推荐一些国内镜像源

        阿里云镜像:https://maven.aliyun.com/repository/public

        腾讯云镜像:https://mirrors.cloud.tencent.com/nexus/repository/maven-public/

        华为云镜像:https://repo.huaweicloud.com/repository/maven/

3. 具体配置步骤

3.1 全局配置

        找到 Maven 安装目录下的 conf/settings.xml 文件,在 <mirrors> 标签内添加以下配置:

<mirrors>
    <mirror>
        <id>aliyun-maven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>

        <!-- url这里是阿里云镜像,可以替换成上面提到的其他镜像源 -->
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

打开Maven

里面的 .m2

打开 setting.xml

在如下部分添加

3.2 也可以在你的项目上配置

        在项目的 pom.xml 文件中添加以下配置:

<repositories>
    <repository>
        <id>aliyun-maven</id>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

<pluginRepositories>
    <pluginRepository>
        <id>aliyun-maven</id>
        <name>阿里云插件仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </pluginRepository>
</pluginRepositories>

        同样的,如果速度慢可以换其他镜像源试试

3.3 在 IDEA 配置

  1.  打开 IDEA,进入 File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven
  2.  在 User settings file 中指定你的 settings.xml 文件路径
  3.  点击 Apply 和 OK 保存配置

3.4 验证配置

在项目根目录执行以下命令,观察下载速度:

mvn clean install

或者在 IDEA 中点击右侧 Maven 面板的刷新按钮重新加载依赖。

这就不贴图了

4. 常见问题

4.1 如果配置后仍然很慢

  1. 检查 settings.xml 文件是否正确加载
  2. 确认 <mirrorOf> 配置为 central 或 *
  3. 清理本地仓库缓存:删除 ~/.m2/repository 目录后重新下载

  注意这里用 <mirrorOf>*</mirrorOf> 会拦截所有仓库请求并转到阿里云镜像。

  配置后重新运行 mvn clean install 即可。

4.2 有时候部分依赖下载失败

        可能是某些私有依赖不在公共镜像中,需要配置额外的仓库地址

        实在不行可以配置多个镜像源作为备选

5. 一些注意事项

  •         全局配置会影响所有 Maven 项目,比较方便,所以推荐使用此方式
  •         项目级配置仅对当前项目生效
  •         要定期检查镜像源的可用性,有时候镜像源可能变更,必要时更换备用镜像

因为默认源在国外,国内下载慢到离谱,甚至直接失败。通过配置国内镜像源,可以有效解决 Maven 依赖下载慢的问题。

技术分享~ 持续更新中~

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐