idea中maven配置（一次成功，全部细节都有）

news2024/11/15 11:56:22

写这篇文章的原因是maven的配置很简单，但是也很容易出错，我连配了两台电脑的maven出现了各种小错误，参考了以下两篇博文IDEA配置Maven教程（超详细版~)_idea maven配置教程-CSDN博客

一次包会——最新IDEA配置Maven指南（2023年最新）_idea2023配置maven-CSDN博客

现将maven配置总结如下：

一、下载maven

在这里只有一个点要注意就是下载的maven的版本不能高于idea中maven默认的版本（一定要注意）。

在如下图中查看idea的maven版本。

下载链接（maven3.8.8的下载链接，如果idea中的maven高于3.8.8请去官网maven官方网站下载适合的版本）

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

二、创建专属maven的文件夹

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

注意：如果不太熟悉环境配置的话就严格按照这个层次来建立文件夹。

三、修改settings.xml文件

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

在框框的下面加上一段代码，代码如下（直接复制粘贴就行）：

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

注意：一定要把位置搞对，不要搞混mirrors和mirror标签。

添加完成后，应该如下图。（注意保存）

还有一个地方要改，这个地方很重要，我之前就是在这里卡了很久。

在配置文件（也就是这个settings.xml文件）中找到localRepository标签，这个标签配置的是本地仓库的位置，可以自定义一个文件夹用来保存（尽量不要使使用中文），maven项目会先从本地仓库中寻找依赖，如果找不到，再会去中央仓库下载，下载下来的依赖包会被保存到本地仓库。

四、配置maven环境变量

复制Maven所在的路径 D:\maven\apache-maven-3.6.3，此电脑右键选择属性->高级系统设置->环境变量

变量名为MAVEN_HOME, 变量值为 D:\maven\apache-maven-3.6.3，点击确定

选择Path，点击编辑

后面都点击确定直至推出所有对话框，然后打开cmd命令行，输入mvn -v，显示出maven的版本号即证明MAVEN环境变量配置成功，可以全局引用了

五、在idea中配置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