【Maven】安装配置及常见问题的解决

Maven安装与配置

• 环境
• 1 Maven的下载
• Maven的配置
• 1 JDK环境
• 2 配置环境变量
• 新建两个系统变量
• 编辑Path环境变量
• 测试
• 修改配置文件
• 一些问题及解决办法
• 1 The JAVA_HOME environment variable is not defined correctly，this environment variable is needed to run this program.问题原因
• 2 maven配置完成后cmd执行mvn help:system一直失败：BUILD FAILURE
• 1 网络问题
• 2 镜像问题
• 3 以上都不是

环境

系统：Win 11
maven版本：Apache Maven 3.8.5
JDK：1.8
idea版本：2021.3

1 Maven的下载

Maven官网下载地址：Maven下载

下载后解压，建议解压到D盘或E盘。

1. 解压后目录

   

目录不一致请重新检查自己下载的压缩包是否正确

Maven的配置

1 JDK环境

jdk环境要先配置好，这里使用的是jdk1.8

2 配置环境变量

新建两个系统变量

（1）添加M2_HOME:对应Maven的解压目录下的bin目录即可。
（2）添加MAVEN_HOME:对应Maven的解压目录即可。

编辑Path环境变量

注意：%MAVEN_HOME%后面有bin，%M2_HOME%下面不需要bin

测试

在cmd下输入
mvn -v

出现上图界面则安装成功

修改配置文件

打开settings.xml文件（写字板打开或者notepad打开）

（1）本地仓库位置修改

在标签内添加自己的本地位置路径

  <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->
	<localRepository>D:/.m/repository</localRepository>

圈出的路径是自己设置，在建议在D或E新建空白文件夹，不要放在C，C盘太满容易出问题

（2）修改maven默认的JDK版本

默认的JDK版本是5，因此要修改成自己配置的jdk环境

在标签下添加一个标签，修改maven默认的JDK版本。

一定要注意不要加到注释内。

<profile>     
    <id>JDK-1.8</id>       
    <activation>       
        <activeByDefault>true</activeByDefault>       
        <jdk>1.8</jdk>       
    </activation>       
    <properties>       
        <maven.compiler.source>1.8</maven.compiler.source>       
        <maven.compiler.target>1.8</maven.compiler.target>       
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>       
    </properties>
</profile>

（3）添加国内镜像源

在标签下，添加国内镜像源，使用阿里云镜像库即可。

修改镜像之后下载速度会快很多。

 <!-- 阿里云仓库 -->
        <mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
        </mirror>
     或者
      <mirror>
		<id>nexus-aliyun</id>
		<mirrorOf>*</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
	 </mirror>

**建议配置第二个，有用户反应第一个会出现Warning**

配置完成，在命令行输入mvn help:system测试，看到下载链接里面是ailiyun的链接，然后出现BUILD SUCCESS则表示配置成功

一些问题及解决办法

1 The JAVA_HOME environment variable is not defined correctly，this environment variable is needed to run this program.

问题原因

JAVA_HOME配置出错
解决方法：检查用户变量和系统变量的JAVA_HOME是否一致

后面不要带分号，如果有请双击之后点编辑文本，可以去掉

2 maven配置完成后cmd执行mvn help:system一直失败：BUILD FAILURE

1 网络问题

解决方法：检查网络

2 镜像问题

解决方法：查看配置文件settings.xml 国内镜像源是否配置正确

3 以上都不是

解决方法：重启一个cmd
输入命令：mvn help:describe -dplugin=help -e -X
重启cmd 再次执行 mvn help:system
此时成功出现：BUILD SUCCESS