Maven环境变量配置保姆级教程（含避坑指南）

最近帮学弟配置Maven环境踩了不少坑😭发现网上教程要么太老要么漏关键步骤！今天手把手教你们从零开始配置Maven环境变量（Windows+Mac双版本），附带3个新手必踩的坑和解决方法，看完保你一次成功！

一、为什么要配置环境变量？

简单来说就是让系统能在任何路径下找到mvn命令！（举个栗子🌰：就像给快递小哥设置默认收货地址，不用每次都报完整地址）没配环境变量的话，每次都要进Maven安装目录才能执行命令，那酸爽谁用谁知道！

二、配置前准备工作

1. 已安装JDK 1.8+（必须！！！）

   • 验证方法：终端输入java -version
   • 出现版本号才算成功（没装的快去Oracle官网下载）

2. 下载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项目试试水！如果出现下载依赖卡住，可能需要换国内镜像源（下期教你们怎么配阿里云镜像，关注不迷路~）

遇到问题欢迎评论区留言，看到必回！觉得有用记得点赞收藏🌟，转发给需要的朋友！