在使用IntelliJ IDEA进行Java开发时,Maven默认从国外中央仓库下载依赖,经常会出现速度很慢甚至卡住的情况。通过给Maven配置阿里云镜像源,可以把下载地址指向国内节点,从而显著提升依赖获取速度。

为什么Maven依赖下载慢
Maven核心配置里默认的仓库地址是 repo.maven.apache.org,服务器位于国外。国内网络访问时延迟高、带宽受限,当项目依赖较多时就会明显变慢。我们可以在Maven的配置文件里添加镜像,让请求转发到阿里云提供的仓库。
找到IDEA使用的Maven配置文件
IDEA自带Maven,也允许使用本地安装版本。一般在以下位置可以找到或创建 settings.xml:
- IDEA内置Maven:安装目录/plugins/maven/lib/maven3/conf/settings.xml
- 用户目录:当前系统用户家目录下的 .m2/settings.xml
如果 .m2 目录下没有 settings.xml,直接新建一个即可,IDEA会在构建时读取它。
配置阿里云镜像源实战
在 settings.xml 的 <mirrors> 节点内加入阿里云镜像配置。如果原来没有 <mirrors> 标签,就手动补上。完整示例如下:
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<mirrors>
<!-- 配置阿里云公共仓库镜像 -->
<mirror>
<id>aliyun-maven</id>
<name>Aliyun Maven Mirror</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
</settings>
其中 <mirrorOf>central</mirrorOf> 表示对中央仓库的请求都走这个镜像。若想让所有仓库都走阿里云,可以把值写成 external:*,但一般写 central 就够了。
在IDEA中生效配置
修改完文件后,打开IDEA,进入设置界面检查Maven配置:
- Build, Execution, Deployment - Build Tools - Maven
- 确认 User settings file 指向我们改过的 settings.xml
- 勾选 Override 以便手动指定路径
随后在Maven工具窗口点击刷新按钮,或者执行以下命令强制重新下载:
mvn clean install -U
验证速度是否提升
重新构建时观察底部日志,依赖地址应显示为 maven.aliyun.com。原本几分钟都下不完的包,通常十几秒就能完成。如果仍有个别依赖慢,可在阿里云镜像里补充对应仓库,例如 jcenter 或 google 的专属镜像节点。
小结
解决IDEA下载Maven依赖慢的核心是更换为国内镜像。按上面实战步骤配置阿里云镜像源后,日常开发的等待时间会大幅减少,环境也更加稳定。