文章目录
一、为什么要配置环境变量？二、配置前准备工作三、Windows环境配置（重点！）1. 解压安装包2. 配置系统变量（超级重要）3. 验证配置
四、Mac/Linux环境配置1. 解压安装包2. 配置环境变量3. 验证配置
五、必看避坑指南！！！坑1：配置完环境变量不生效？坑2：权限问题（Mac专属）坑3：版本冲突
六、高级技巧1. 快速切换版本（开发者必备）2. 查看详细配置
七、配置检查清单 ✅
最近帮学弟配置Maven环境踩了不少坑😭发现网上教程要么太老要么漏关键步骤！今天手把手教你们从零开始配置Maven环境变量（Windows+Mac双版本），附带3个新手必踩的坑和解决方法，看完保你一次成功！
一、为什么要配置环境变量？
简单来说就是让系统能在任何路径下找到mvn命令！（举个栗子🌰：就像给快递小哥设置默认收货地址，不用每次都报完整地址）没配环境变量的话，每次都要进Maven安装目录才能执行命令，那酸爽谁用谁知道！
二、配置前准备工作
已安装JDK 1.8+（必须！！！）
验证方法：终端输入java -version出现版本号才算成功（没装的快去Oracle官网下载） 下载Maven安装包（推荐3.6.3稳定版）
官网地址：https://maven.apache.org小技巧：下载binary zip包（带-bin的）
三、Windows环境配置（重点！）
1. 解压安装包
建议路径：C:\Program Files\apache-maven-3.6.3 （不要放中文路径！不要放桌面！血的教训）
2. 配置系统变量（超级重要）
① 右键【此电脑】→【属性】→【高级系统设置】→【环境变量】 ② 新建系统变量：
变量名：MAVEN_HOME变量值：你的Maven安装路径（比如C:\Program Files\apache-maven-3.6.3）
③ 编辑Path变量： 新建→输入%MAVEN_HOME%\bin （注意是追加不是覆盖！别把原来的删了）
3. 验证配置
打开cmd输入：
mvn -v
看到类似下图说明成功！ （如果报错’不是内部命令’，99%是Path没配好）
四、Mac/Linux环境配置
1. 解压安装包
建议路径：/usr/local/apache-maven-3.6.3
2. 配置环境变量
打开终端执行：
vim ~/.bash_profile
添加以下内容：
export MAVEN_HOME=/usr/local/apache-maven-3.6.3
export PATH=$PATH:$MAVEN_HOME/bin
保存退出后执行：
source ~/.bash_profile
3. 验证配置
mvn -v
出现版本信息即成功！
五、必看避坑指南！！！
坑1：配置完环境变量不生效？
解决方法：
Windows用户重启cmd（重要！）Mac用户检查是否执行了source命令检查Path中的分号/冒号（Windows用; Mac用:）
坑2：权限问题（Mac专属）
如果提示Permission denied：
sudo chmod -R 755 /usr/local/apache-maven-3.6.3
坑3：版本冲突
多个Maven版本共存时：
Windows：在Path里调整顺序Mac：使用alias别名切换版本
六、高级技巧
1. 快速切换版本（开发者必备）
在环境变量里把MAVEN_HOME改成其他版本路径，重新source或重启终端即可
2. 查看详细配置
mvn -X
这个命令会显示Maven使用的所有环境变量和配置（debug神器）
七、配置检查清单 ✅
MAVEN_HOME变量存在且路径正确 Path变量包含%MAVEN_HOME%\bin（Win）或$MAVEN_HOME/bin（Mac） 已重启终端/CMD JDK版本≥1.8 安装路径无中文/空格
配置完记得去创建个Maven项目试试水！如果出现下载依赖卡住，可能需要换国内镜像源（下期教你们怎么配阿里云镜像，关注不迷路~）
遇到问题欢迎评论区留言，看到必回！觉得有用记得点赞收藏🌟，转发给需要的朋友！