大家好，作为常年和Java项目打交道的开发人员，Maven是日常编程中特别常用的项目构建与依赖管理工具，不少刚接触这款工具的新手，总会卡在安装配置与IDEA集成这两个环节，要么因为环境变量配置失误导致命令无法使用，要么因为IDEA自带Maven与本地版本冲突而出问题，依赖下载速度慢、仓库报错也是大家经常会遇到的麻烦。
这篇教程从零基础起步，一步步带着大家在Windows系统上完成Maven安装、环境配置，还会讲解IntelliJ IDEA里Maven的全套配置方法，全程步骤详细不啰嗦，新手跟着一步步操作就能顺利完成，看完之后再也不用为Maven配置出错的问题发愁。
一、前置准备：确认JDK环境
Maven是依托Java语言开发的工具，想要正常运行就必须搭配JDK环境，所以安装Maven之前，大家一定要先检查电脑是否已经安装并配置好JDK。
大家可以先按下Win+R组合键，输入cmd打开命令提示符窗口，接着在窗口内输入下方两条命令，检查电脑的JDK环境是否正常：
java -version
javac -version
要是命令执行后能正常显示JDK版本号码，就说明JDK环境没有问题，如果系统提示不是内部或外部命令，大家就要先安装JDK，同时完成JAVA_HOME环境变量的配置，这里推荐大家使用JDK1.8及以上版本，能适配市面上绝大多数Maven版本，兼容效果也更稳定。
二、Maven 下载（Windows 专属压缩包）
Maven安装包一定要去Apache官方网站下载，这样能避开第三方安装包捆绑软件、版本不兼容的问题，这里直接给大家附上官方的下载链接。
- 打开电脑浏览器，直接访问Maven官方下载页面；
- 向下滑动页面找到Files板块，Windows系统要选择Binary zip archive格式的压缩包，千万不要下载源码版（Source zip archive），因为源码版本无法直接解压使用；
- 推荐大家下载稳定正式版本，比如3.8.x、3.9.x系列，新手尽量不要下载最新的alpha测试版本，避免使用过程中出现各类未知故障；
- 下载完成后，大家会得到apache-maven-x.x.x-bin.zip压缩包，这里一定要牢记，解压文件的路径不能出现中文、空格、特殊字符，建议直接放在D盘或者E盘的根目录下，比如D:\apache-maven-3.9.6，路径越简洁，后续使用越不容易出现错误。
三、Windows 系统环境变量配置
配置环境变量的目的，是让Maven的mvn命令在电脑任意位置都能正常调用，这一步是整个安装流程的关键，每一步操作都不能出现失误。
3.1 配置 MAVEN_HOME 系统变量
- 右键点击桌面上的「此电脑」图标，选择「属性」选项打开系统设置页面，再在页面右侧找到「高级系统设置」并点击进入。
- 在弹出的系统属性窗口中，点击下方的「环境变量」选项，进入环境变量配置界面。
- 在页面下方的「系统变量」区域，点击「新建」按钮，创建一个全新的系统变量。
变量名填写MAVEN_HOME，变量值直接填写之前Maven的解压根目录，比如D:\apache-maven-3.9.6，大家直接复制文件夹路径即可，注意不要多嵌套一层子目录。
变量值：填写刚才Maven的解压根目录，比如D:\apache-maven-3.9.6（直接复制文件夹路径，不要多一层子目录）
- 全部填写完成后，点击确定按钮，保存新建好的系统变量即可。
3.2 配置 Path 系统变量
- 在系统变量列表中找到名为Path的变量，选中该变量后点击「编辑」按钮，打开Path变量配置窗口。
在弹出的编辑窗口里，点击「新建」按钮，添加下方的路径信息。
%MAVEN_HOME%\bin
- 路径添加完成后，依次点击所有窗口的「确定」按钮保存设置，千万不要直接关闭窗口，否则配置好的环境变量无法生效。
3.3 验证 Maven 环境是否配置成功
环境变量配置完毕后，一定要验证配置是否成功，这一步能提前排查各类配置失误，避免后续使用出问题。
- 重新打开cmd命令提示符窗口，一定要重新开启窗口，因为之前打开的cmd无法读取最新的环境变量配置。
- 输入指令：mvn -v
如果命令能够正常运行，并且显示出Maven版本、Java版本、系统版本等相关信息，就说明环境变量配置成功，要是系统提示“mvn不是内部或外部命令”，大家就回头检查路径是否正确、变量名有无写错、Path配置是否完整。
四、Maven 核心配置：本地仓库 + 阿里云镜像
Maven默认配置有两处不足，本地仓库默认存放在C盘用户目录下，很容易占用C盘存储空间，默认镜像服务器在国外，不仅依赖下载速度极慢，还时常出现下载失败的情况，所以这一步必须修改配置，提升日常使用效率。
4.1 新建本地仓库文件夹
- 打开Maven解压后的根目录，在目录内新建一个文件夹，专门用来存放Maven下载的依赖包，建议大家将文件夹命名为maven_repository。
- 给大家参考示例路径：D:\apache-maven-3.9.6\maven_repository，复制好这个路径，后续修改配置文件时会直接用到。
4.2 修改 settings.xml 配置文件
- 进入Maven目录下的conf文件夹，找到settings.xml配置文件，用记事本、Notepad++这类文本编辑器打开即可。
配置本地仓库：在settings标签内部，找到被注释的localRepository标签，在它下方添加一行代码，路径直接填写之前新建的仓库文件夹路径。
D:\apache-maven-3.9.6\maven_repository 配置阿里云镜像加快下载速度：在mirrors标签内部，添加下方阿里云镜像配置内容，替换掉原本默认的国外镜像。
<id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/public</url>- 保存文件并关闭编辑器，配置生效后，后续Maven下载的所有依赖都会存入指定的本地仓库，依赖下载速度也会大幅提升。
五、IntelliJ IDEA 配置 Maven（全局+项目通用）
很多新手配置完本地Maven后，IDEA依旧使用自带的Maven版本，进而引发依赖冲突、配置不生效的问题，这里分两种场景讲解配置方法，新手推荐先配置全局Maven，后续新建项目会自动沿用这套配置。
5.1 IDEA 全局 Maven 配置（新建项目默认生效）
- 打开IDEA进入初始欢迎页面，注意不要打开任何已经存在的项目。
- 点击页面右下角的「Customize」选项，选择「All settings」，打开IDEA全局设置界面。
- 在左侧的设置列表里，依次展开路径：Build, Execution, Deployment → Build Tools → Maven。
- 完成三项核心配置，全部取消系统默认选项，统一改成本地Maven的配置信息。
- Maven home path：选择本地Maven解压的根目录，比如D:\apache-maven-3.9.6；
- User settings file：勾选Override选项，选择conf文件夹内的settings.xml配置文件；
- Local repository：勾选Override选项，系统会自动识别配置好的本地仓库路径，不需要手动修改；
- 补充配置：点击左侧Maven栏目下的「Runner」选项，在JRE下拉列表中，选择本地安装好的JDK版本，避免出现JDK版本冲突的问题。
- 点击Apply → OK保存全局设置，后续所有新建项目都会默认使用这套本地Maven配置。
5.2 已有项目 Maven 配置
如果是已经打开运行的Java项目，直接按照下方步骤修改配置即可。
- 点击IDEA顶部菜单栏的「File」→「Settings」，也可以直接用快捷键Ctrl+Alt+S快速打开。
- 重复全局配置里Maven的三项核心操作，将路径、配置文件、本地仓库都改成本地Maven的对应信息。
- 配置完成后，右键点击项目中的pom.xml文件，选择「Maven」→「Reload Project」，刷新项目依赖即可生效。
六、IDEA 中 Maven 常用操作 & 避坑提示
6.1 常用操作
- 下载依赖：修改pom.xml文件后，点击右上角的刷新按钮，系统就会自动下载所需的依赖包；
- 清理项目：打开右侧的Maven窗口，选择Lifecycle → clean，即可清理项目编译生成的文件；
- 打包项目：选择Lifecycle → package，就能一键把项目打包成jar/war格式的安装包；
- 安装依赖：选择Lifecycle → install，就能把依赖存入本地仓库，方便其他项目直接调用。
6.2 新手避坑
- Maven的存放路径千万不能有中文、空格，否则IDEA无法正常识别工具；
- 不要混用IDEA自带Maven和本地Maven，全程只使用本地版本就不会出现冲突；
- 依赖下载失败时，先删除本地仓库里对应的依赖文件夹，之后再重新刷新下载即可；
- 每次修改完settings.xml文件，一定要在IDEA里重新执行Reload Project操作，让新配置完全生效。
七、最后总结
整套Maven安装配置流程主要分为五步，分别是准备JDK环境、下载解压安装包、配置系统环境变量、修改本地仓库与镜像、IDEA工具集成，只要跟着教程一步步操作，基本不会出现配置错误。
对于Java开发人员来说，Maven是必备的基础工具，把配置流程梳理通顺，后续日常开发、依赖管理、项目打包都会变得更加顺畅。