2024年4月更新——IDEA 2022&2023&2024 配置Maven一次包过教程

---

前言

Maven是当今Java开发中主流的依赖管理工具，那么小伙伴们在刚开始学习的时候呢，IDEA配置Maven肯定会遇到许多问题，在此呢我出一版精炼的IDEA配置Maven的教程，只要你按着我的步骤一步步来，就一定能配置成功😀，少说废话，全是干货，那么开始吧，觉得内容不错的同学记得动动小手点个赞哦👍。

---

注意🔞：适用的IDEA版本

• IDEA 2022、2023和2024
• 2021版的教程戳这里 → Intellij IDEA 2021 Maven 配置指南

---

视频版教程

觉得文章枯燥喜欢跟着视频的小伙伴可以到B站查看博主录制的详细教程
https://www.bilibili.com/video/BV1gM4y167Tw/

---

---

一、下载Apache Maven

首先我们来到Maven版本历史页 http://maven.apache.org/docs/history.html（现在打开可能有点慢🤔），在这里有它的版本历史和发行日期，可以看到maven已经出到版本4.0+了，选择合适的版本下载即可。（温馨提示，点击博文的图片可以放大查看哦~）

选择合适的版本

如果你不确定该选择什么版本的话，可以打开IDEA设置搜索maven，然后再maven主路径这里可以看到IDEA内置的maven版本是3.9.5（2023.3），为了保险起见，我们只需要选择不大于该版本的主流版本即可。

附：2024.1内置maven为3.9.6

如果你的IDEA是2021版本的话，请选择3.6.3版本，太高的版本会出现报错，这里我的IDEA是2023版本，我选择比较稳定的版本，例如3.8.8，当然了如果你的IDEA版本是最新的也可以尝试使用新版maven，然后我们可以到下载集合页 https://archive.apache.org/dist/maven/maven-3/ 查看和下载所有3.x发行版本。

点击 binaries/ 进入压缩包的下载页面

windows的用户选择zip版本下载即可

贴心的博主直接放下载链接给你们，不用自己去找，若浏览器下载速度缓慢可以使用迅雷等下载工具

下载链接🐱

3.8.8
https://archive.apache.org/dist/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.zip

3.9.6
https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.zip

创建Maven目录和Maven本地仓库

下载完成后，我们在某个盘（例如D盘）的根目录（随便什么目录都行，但要注意路径最好不要出现中文或者空格），新建一个名为maven的文件夹，然后把压缩包解压后的文件夹放在里面，我们还要新建一个maven本地仓库文件夹，名字随便但是一般叫做repository即可（代表仓库的意思）。以上文件夹绝对路径保持全是英文名，文件夹名称不要为中文，例如D:\maven\repository 。综上所述，目录结构可参考如下：

💻D:
  └─📂maven
       ├─📂apache-maven-3.8.8
       └─📂repository

为什么要配置本地仓库？
因为本地仓库的默认位置在C盘，即 C:/User/你的用户名/.m2/repository 的位置，在开发过程中会下载大量的jar包，久而久之本地仓库越来越臃肿，为了减轻C盘压力和便于管理，建议还是单独存放在其他磁盘，这里我选择和maven程序放在一起，便于管理。

二、修改Maven配置文件settings.xml

简介❓（是什么、为什么）

这一步是配置maven中央仓库的位置，也就是要去哪里下载项目依赖的本地没有的jar包，我们需要改成阿里云的镜像，因为默认maven中央仓库的服务器在国外，下载依赖的速度会比较慢，改成阿里云镜像速度会很快。

步骤❗（怎么做）

首先在maven文件夹的conf目录下找到settings.xml👈，用vscode等编辑器打开，定位到159-165行左右

将粉色框框的这一段代码的下面：

<mirror>
  <id>maven-default-http-blocker</id>
  <mirrorOf>external:http:*</mirrorOf>
  <name>Pseudo repository to mirror external repositories initially using HTTP.</name>
  <url>http://0.0.0.0/</url>
  <blocked>true</blocked>
</mirror>

增加以下代码，保存即可，这里要注意❗标签有没有闭合，不要弄混mirrors和mirror标签

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

注：此段配置来源于阿里云官方指南 https://developer.aliyun.com/mvn/guide

修改后的代码：

三、在Intellij IDEA 2023中配置Maven

🆘注意：确保你是在IDEA的欢迎界面进行配置，这一步很重要，决定了你的配置是不是全局的，如果你在项目中的话，请点击菜单的“文件”-"关闭项目"回到欢迎界面，一定要注意！！！

步骤1—— 在欢迎界面打开设置

点击所有设置，或者直接用打开设置的快捷键 Ctrl + Alt + S

步骤2—— 找到maven配置项

左上角搜索框搜索maven，回车，主要修改红色框内的几个配置

步骤3—— 修改maven配置

按照下图配置即可，maven的主路径指的就是maven的主文件夹，用户设置文件就是我们刚刚上面第二步修改配置的那个文件settings.xml，本地仓库就是我们自己新建的一个文件夹，所有从中央仓库下载的jar包会放在这里面，如果你按照我上面的思路配置，那么这三个路径应该是这种：

Maven主路径：D:\maven\apache-maven-3.8.8
用户设置文件：D:\maven\apache-maven-3.8.8\conf\settings.xml
本地仓库：D:\maven\repository

附：本地仓库另一种配法（拓展，可跳过不看）

---

其中， 本地仓库的位置还有另一种配法——在settings.xml中配置。可以看到本地仓库默认是在C:\用户主文件夹.m2\repository

我们就不取消注释原配置了，直接在粉色框框的下方增加这段配置即可

<localRepository>D:\maven\repository</localRepository>

取消勾选重写的话，IDEA也会自动读取这段配置

可以看到IDEA也会自动读取这段配置（重启IDEA后查看）

不过，我还是推荐使用重写的方式，直接选取目标文件夹，操作起来更加直观方便一些
默认配置无需修改

🔚以上就是本地仓库的另一种配法

---

细节注意

修改完成后记得点击应用（Apply） 或者 确定（OK），不要直接右上角关闭了

步骤4—— 配置运行程序虚拟机参数

简介❓（为什么要配置，了解即可）

然后还有一个问题，使用IDEA创建maven项目时，idea会根据maven archetype的配置，执行 mvn archetype:generate 命令，并且需要指定一个archetype-catalog.xml文件。

该命令的参数-DarchetypeCatalog，可选值为[remote, internal, local]，用来指定archetype-catalog.xml文件从哪里获取。

默认为remote，即从 https://repo1.maven.org/maven2/archetype-catalog.xml 下载archetype-catalog.xml文件。体积约为10M，就会导致下载速度很慢，从而创建过程经常会被卡住。

不过现在大概率不会影响构建过程，而是看见以下警告 “No archetype found in remote catalog. Defaulting to internal catalog.”，表示没有找到这个模版，如果我们不想看到这个警告的话则继续以下的配置。

步骤❗（怎么做）

这里解决的方法一般有三种，感兴趣的可以从其他博客了解，这里我只选择最方便快捷一劳永逸的一种👈，就是修改maven的VM Options参数配置。

-DarchetypeCatalog=internal

修改完记得点击应用（Apply） 或者 确定（OK）

步骤5—— 重启IDEA

点击确定或应用，然后关闭IDEA
重新打开IDEA，查看刚刚的设置有没有生效❗
如果刚刚的设置又变回默认设置了，就再配一次，直到重启打开设置生效
IDEA高版本经常出现此类问题，如果不行重试几次即可。

按照博文上述操作重新配置之后，再次重启IDEA打开设置查看就没问题了

步骤6—— 新建项目与测试效果

创建新项目试试效果，选择的jdk是11，选择的模板是webapp

初次下载会久一点，看见是阿里云的域名即可，通常在短时间内即可下载完成。

打开设置，定位到Maven配置，查看配置，的确有生效即为正常

如果遇到这种情况的话说明此时还在下载基础的依赖插件，稍等片刻后会下载完成，可以看见右下角有个进度，完成后点击同步按钮重新同步即可

四、流程总结

1. 下载maven压缩包，解压并修改conf目录下的setting.xml，主要配置镜像即可，提高依赖下载速度
2. 准备一个文件夹，存放解压后的的maven文件夹和maven本地仓库
3. 打开IDEA的设置→构建、执行、部署→构建工具→Maven
4. 配置Maven菜单下的→Maven主路径、用户设置文件和本地仓库
5. 配置Maven二级菜单下的→运行程序→VM选项（可选，推荐配置一下以免出现警告）
6. 重启IDEA，查看各个设置是否已经生效，如果有某项不生效则修改完重启直到所有配置生效为止
7. 创建新的项目，测试下载速度和是否从阿里云下载依赖，第一次要下载大量依赖到本地仓库，因此速度可能在一两分钟左右

五、问题排查

Q：为什么我看了博主的教程还是不行

A：也许你没有完全仔细认真按照我的教程一步步配置，如果按我的教程配置的话，是100%成功的，再仔细检查看看是哪一步出了错误。如果已经新建了项目，则退出项目，把上述流程再仔仔细细重新走一遍，然后重新创建一个新项目测试效果。这里我也给出几种新手常见的错误操作：

1. 白嫖文章，没有给博主点赞收藏加关注🚫😫
2. IDEA版本和Maven版本没有对应上，2021最好选择3.6.3稳定版，2022和2023可以选择3.8.8版本
3. 进行全局配置maven的时候没有退出到欢迎界面，这一步非常重要，不然你配置的就只是针对这个项目的
4. 忘记配置vm选项 -DarchetypeCatalog=internal （现在大概率不影响）
5. IDEA就是这么蛋疼，有时候明明配置了重启后又发现没配置，请多仔细检查
6. 在已有的项目中测试失败了，改好配置后没有新建一个项目测试而是继续在这个项目测试效果

六、结语

到此教程就结束了，你们学废了吗，还不快把学费交了，赶紧三连走一波🤩😍~

推荐阅读😆

👋必看！VSCode字体美化教程
👋Intellij IDEA 2021 Maven 配置指南