maven 安装配置核心分为下载安装包 配置系统环境变量 修改 settings.xml 本地仓库和国内镜像 校验安装是否成功这几个环节，maven 是基于 Java 的项目构建工具，所以前置硬性条件是电脑已经装好 JDK 并且 JDK 环境变量正常生效，没有 JDK 的情况下，maven 就算解压完成，执行 mvn 命令也会直接报错，很多新手做 maven 安装配置的时候，只关注 maven 本身，忽略 JDK 版本匹配，maven3.6 以上版本推荐 JDK8 及以上，高版本 maven 对 JDK 版本要求会更高。maven 安装配置不需要传统下一步式安装程序，官方提供的是压缩包，解压即可使用，属于绿色软件，配置完环境变量之后，就可以在 cmd 终端任意目录调用 mvn 指令，同时推荐修改默认本地仓库位置，默认仓库在 C 盘用户目录，长期构建项目会占用大量 C 盘空间，搭配阿里云镜像可以大幅提升依赖下载速度，解决国外中央仓库下载慢超时的问题。
一 前置准备
1 确认 JDK 已经安装，打开 cmd 输入 java -version，能够正常输出版本信息代表 JDK 正常
2 从 Apache Maven 官方站点下载对应版本二进制压缩包，一般选择 apache-maven-x.x.x-bin.zip
3 选择纯英文无空格路径解压，比如 D:\apache-maven-3.9.6，路径不要包含中文空格特殊符号，这是 maven 安装配置很关键的一点，中文路径经常引发依赖读取异常
二 Windows 系统环境变量配置
1 右键此电脑，选择属性，打开高级系统设置，点击环境变量
2 在系统变量区域，新建变量 MAVEN_HOME，变量值填写 maven 解压根目录，也就是 D:\apache-maven-3.9.6
3 找到系统变量里面的 Path，双击编辑，新增一条 % MAVEN_HOME%\bin
4 全部窗口点击确定保存，关闭已经打开的 cmd 窗口，重新新开 cmd，输入 mvn -v
5 如果输出版本号 JDK 信息，代表 maven 安装配置环境变量部分成功
三 settings.xml 核心配置
settings.xml 文件位置在 maven 解压目录 conf 文件夹里面，这个文件是 maven 安装配置最重要的配置文件
本地仓库配置
找到 localRepository 标签，修改成自定义路径，例如
这个目录就是后续所有 jar 包依赖存放位置，需要提前手动创建文件夹
国内阿里云镜像配置
在 mirrors 标签内部添加阿里云镜像，替换默认中央仓库，解决下载缓慢超时
JDK 编译版本配置
在 profiles 里面配置默认编译 JDK 版本，统一项目编译级别，避免项目默认 JDK 版本不匹配报错
四 校验 maven 安装配置是否成功
新开 cmd 终端，执行 mvn clean，或者执行 mvn help:system
执行之后 maven 会自动读取 settings.xml，下载基础依赖，如果没有报错，并且本地仓库目录生成 jar 文件，说明 maven 安装配置全部生效
如果 IDEA 里面集成 maven，还需要在 IDEA 设置里面，把 Maven home directory 指向自己解压的 maven 目录，User settings file 选择修改后的 settings.xml，不要继续使用 IDEA 自带默认 maven
五 关键项目对比表格
| 配置项目 | 默认值 | 推荐修改 | 作用 |
|---|---|---|---|
| 本地仓库 | C 盘用户目录 .m2 | 自定义 D 盘目录 | 释放 C 盘空间 |
| 远程仓库 | maven 中央仓库 | 阿里云镜像 | 加快依赖下载 |
| 编译 JDK | 跟随项目 | 统一 JDK8 | 统一编译标准 |
| MAVEN_HOME | 无 | maven 根目录 | 供 Path 调用 |
六 常见报错原因
1 mvn 不是内部或外部命令，代表 MAVEN_HOME 或者 Path 配置错误，或者没有重启 cmd
2 提示 JAVA_HOME 未找到，JDK 环境变量 JAVA_HOME 没有配置
3 依赖下载超时，没有配置国内镜像，或者网络不通
4 本地仓库 jar 包损坏，删除对应 jar 包重新下载
5 路径中文空格，解析 pom.xml 异常
【常见问题】
问题 1 maven 安装配置之后 mvn 提示不是内部命令怎么办
回答 1 maven 安装配置之后出现 mvn 不是内部命令，一般是 Path 变量没有添加 % MAVEN_HOME%\bin，或者配置完成没有重新打开 cmd，maven 安装配置修改环境变量之后必须新开终端才会加载新变量。
问题 2 maven 安装配置一定要修改 settings.xml 本地仓库吗
回答 1 maven 安装配置不是强制修改本地仓库，但是默认仓库在 C 盘，长期使用会占用大量 C 盘空间，maven 安装配置推荐修改本地仓库并且配置阿里云镜像提升下载速度。
问题 3 maven 安装配置 IDEA 里面还需要单独设置吗
回答 1 maven 安装配置完成之后，IDEA 默认可能使用自带 maven，maven 安装配置之后需要进入 IDEA 设置手动指定外部 maven 路径和 settings.xml，否则 IDEA 不会读取你手动做的 maven 安装配置。
【免责申明】
本文 maven 安装配置相关步骤基于 Windows 系统通用版本整理，不同 maven 版本界面和配置标签基本一致，配置请结合 Apache 官方文档，修改配置文件前建议备份原 settings.xml，操作产生项目异常由操作者自行承担，内容仅作学习参考。
