IntelliJ IDEA 2021.3: Maven配置终极指南（超详细且内含亲自踩雷点）

Intellij IDEA 2021 Maven配置超级详细的全教程

官网地址：http://maven.apache.org/docs/history.html

1、下载Apache Maven

1. 进入官网可以看到如上页面，点击下载Download

2. 目前最新版本是3.9.6，亦可以下载历史版本，点击红色箭头指定的windows下载压缩包，另外两个，一个是Linux的一个是源代码

！！！！！！！有坑！！！！！！！

可以跳到第6点看一下，不要下载最新版

谨记：计算机有关的，都不能安装最新版

3. 安装包下载完成，解压到D盘，建议新建文件夹命名maven，不使用中文，使用英文命名！！！

4. 新建一个本地仓库文件夹，叫做maven_repository

2、 环境变量配置

1.选择此电脑鼠标右击属性

2. 找到高级系统设置

3. 点击环境变量

3. 点击系统变量中的新建

4. 根据下图进行设置

变量名为：MAVEN_HOME

变量值 选择解压的maven文件所在

5. 双击击系统变量中的path

新建如下内容%MAVEN_HOME%\bin，点击确定

6. 以管理员身份打开控制台

7. mvn -v 和 mvn -version 提示如下内容，即为成功

3、修改Maven配置文件

1. apache-maven-3.6.3 → conf → 找到settings.xml文件，记事本打开它

<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

2. 找到 <mirrors> 标签，在结束标签 </mirrors> 前增加阿里云镜像的配置

3. 记得保存，快捷键：Ctrl+s

4、Intellij IDEA中配置Maven

本人使用了汉化，但是对照着找应该没问题

1. 启动IDEA，打开设置，快捷键：Ctrl+Alt+S
2. 左侧菜单找到 Build, Execution, Deployment -> Build Tools -> Maven或者构建、执行、部署->构建工具-> Maven

亦可以通过最上方的搜索框直接查找

3. 这是第一个我们要配置的地方

依次选择以下路径，第二三个先需要勾选重写/Override

4. 配置完成如下所示，记得按右下方的应用/Apply

5. 第二个配置，解决：idea创建maven项目速度慢

idea在创建maven项目的时候，本质是执行mvn archetype:generate命令，默认从remote获取archetype-catalog.xml文件，即从 http://repo1.maven.org/maven2/archetype-catalog.xml下载。该文件大约为3~4M，下载速度很慢，导致创建maven项目时需要很长时间

有三招可以破解该问题，都需要对maven的VM Options参数做配置，我找了一个终极破解方法，实现一劳永逸

6. 还是打开我们的设置，找到Build, Execution, Deployment -> Build Tools -> Maven-> 运行程序 或者构建、执行、部署->构建工具-> Maven -> Runner

在maven的VM Options加上-DarchetypeCatalog=internal参数

5、测试Maven

1. 创建新项目New Project，然后我们创建一个maven webapp项目

这里也要记得重新配置跟前面一样的

2. 成功创建项目后，等它运行结束，查看下载的链接中是否有 maven.aliyun.com

可见上图没有，说明配置失败了，因为我们配置的是阿里的镜像，maven下载这个项目的依赖却从中央仓库下载

3. 这样的话则需要再看看哪一步疏漏了重新配置一遍

6、小意外

🥲很可怜地报错了

org.codehaus.plexus.component.repository.exception.ComponentLookupException: com.google.inject.ProvisionException: Unable to provision, see the following errors:

1) [Guice/ErrorInjectingConstructor]: NoSuchMethodError: DefaultModelValidator: method <init>()V not found
  at CustomModelValidator.<init>(CustomModelValidator.java:36)
  while locating CustomModelValidator
  at ClassRealm[maven.ext, parent: ClassRealm[plexus.core, parent: null]]
      \_ installed by: WireModule -> PlexusBindingModule
  while locating ModelValidator annotated with @Named(value=ide)

Learn more:
  https://github.com/google/guice/wiki/ERROR_INJECTING_CONSTRUCTOR

1 error

======================
Full classname legend:
======================
CustomModelValidator:  "org.jetbrains.idea.maven.server.embedder.CustomModelValidator"
DefaultModelValidator: "org.apache.maven.model.validation.DefaultModelValidator"
ModelValidator:        "org.apache.maven.model.validation.ModelValidator"
Named:                 "com.google.inject.name.Named"
PlexusBindingModule:   "org.eclipse.sisu.plexus.PlexusBindingModule"
WireModule:            "org.eclipse.sisu.wire.WireModule"
========================
End of classname legend:
========================

      role: org.apache.maven.model.validation.ModelValidator
  roleHint: ide

上网搜了以下，发现需要降低 maven 版本

针对一些老项目 还是尽量采用 3.6.3版本，针对idea各个版本的兼容性就很兼容

1. IDEA 2022 兼容maven 3.8.1及之前的所用版本
2. IDEA 2021 兼容maven 3.8.1及之前的所用版本
3. IDEA 2020 兼容Maven 3.6.3及之前所有版本
4. IDEA 2018 兼容Maven3.6.1及之前所有版本

如上，希望找到的参考有帮助到你

这里也放了3.6.3的官网原下载地址：【助你一步到位】

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

okk！大获成功🤗
就这样！祝你跟到这里也顺利完成