官网 | 下载 | 仓库

Maven快速安装与配置指南

在官网留意如下信息：

发布时间(Release Date)	版本(Version)	必须JDK版本(Required Java Version)
2019 - 11 - 25	3.6.3	Java 7

确定所选Maven版本符合已安装的Java版本！

安装

• [x] 首先确定已安装Java
• [x] 确定Java最低版本符合Maven要求
• [x] 确定已配置JAVA_HOME环境变量
• [ ] 下载到自定义文件夹右键解压即可（绿色免安装）
• [ ] 在系统变量内配置MAVEN_HOME和Path

环境变量

在系统变量内配置MAVEN_HOME和Path

示例：

变量	值
MAVEN_HOME	D:\web\apache-maven-3.6.3
Path	%MAVEN_HOME%\bin

测试

mvn -v 
# 输出版本信息即可，如果错误，请仔细检查环境变量即可！
# 友好提示，如果此处错误，绝大部分原因都是java_home变量的事，请仔细检查！！

配置

Maven文件结构

• 文件夹 bin：含有Maven的运行脚本
• 文件夹 boot：含有类加载器框架
• 文件夹 conf：含有settings.xml配置文件
• 文件夹 lib：含有Maven运行时所需要的Java类库
• LICENSE：Maven版权信息
• NOTICE：第三方软件等简要介绍
• README.txt：简述

修改Maven默认配置

我们需要需改maven/conf/settings.xml配置文件，来修改maven的一些默认配置。我们主要休要修改的有三个配置：

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>
-->
<!-- conf/settings.xml 55行 -->
<localRepository>D:\repository</localRepository>

2、配置国内阿里镜像

<!--在mirrors节点(标签)下添加中央仓库镜像 160行附近-->
<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

3、以jdk17版本为例配置项目构建

<!--在profiles节点(标签)下添加jdk编译版本 268行附近-->
<profile>
    <id>jdk-17</id>
    <activation>
      <activeByDefault>true</activeByDefault>
      <jdk>17</jdk>
    </activation>
    <properties>
      <maven.compiler.source>17</maven.compiler.source>
      <maven.compiler.target>17</maven.compiler.target>
      <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
    </properties>
</profile>

4、idea配置本地maven

注意：idea工具默认自带maven配置软件，但是因为没有修改配置，建议替换成本地配置好的Maven！

1. 打开idea配置文件，构建工具配置

   设置目录: file -> settings -> build -> build tool-> maven

2. 选中本地Maven

   在Maven home path中选择自己的Maven路径（Maven根目录）

3. 测试是否配置成功

   选中本地Maven后，Local repository会自动变成自己配置的本地Maven仓库目录

   注意：如果本地仓库地址不变化，只有一个原因，就是maven/conf/settings.xml配置文件编写错误！仔细检查即可！

常见问题解答

问题一：IDEA 依赖导入失败

1. 网络或Maven官方仓库宕机问题

解决方案：检查网络连接和Maven官方仓库能否正常访问。

2.依赖项信息错误问题

解决方案：检查所写依赖是否正确，在Maven仓库中是否存在

3.本地Maven仓库被污染或损坏问题

解决方案：去本地Maven仓库清除对应依赖的本地文件，重新刷新pom.xml文件下载即可！