若终端无法识别mvn命令，需安装Maven并配置环境变量：可选Homebrew一键安装；或手动下载解压后，根据shell类型（zsh/bas）修改~/.zshrc或~/.bash_profile添加MAVEN_HOME与PATH；同时确保JAVA_HOME正确且JDK版本≥8；最后建议配置阿里云镜像加速依赖下载。
如果您已在 Mac 系统中安装了 JDK，但终端无法识别 mvn 命令，则说明 Maven 尚未安装或环境变量未正确配置。以下是完成 Maven 安装与环境变量设置的多种可行方法：
一、通过 Homebrew 快速安装并自动配置
Homebrew 是 macOS 上主流的包管理工具，可一键安装 Maven 并将可执行路径自动加入系统 PATH，无需手动编辑配置文件。
1、在终端中执行命令安装 Homebrew（如尚未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、安装完成后，运行以下命令安装 Maven：
brew install maven
3、验证安装结果：
mvn -v
4、若显示 Maven 版本及 Java 版本信息，说明已成功安装且环境变量自动生效。
二、手动下载解压 + 配置 ~/.zshrc（推荐用于 zsh 用户）
macOS Catalina 及之后版本默认使用 zsh，环境变量应写入 ~/.zshrc 文件；该方式对路径控制更精确，便于多版本共存管理。
1、访问 Apache Maven 官网下载最新 tar.gz 二进制包（例如 apache-maven-3.9.6-bin.tar.gz）
2、解压至目标目录，例如：
tar -xzvf apache-maven-3.9.6-bin.tar.gz -C ~/Documents/program/
3、打开终端，执行：
nano ~/.zshrc
4、在文件末尾添加两行（请将路径替换为您的实际解压路径）：
export MAVEN_HOME=~/Documents/program/apache-maven-3.9.6
export PATH=$PATH:$MAVEN_HOME/bin
5、保存退出后执行：
source ~/.zshrc
6、运行 mvn -v 验证，输出版本号即表示配置成功。
三、手动下载解压 + 配置 ~/.bash_profile（适用于 bash 用户或旧系统）
若您的终端仍使用 bash（可通过 echo $SHELL 确认），则需修改 ~/.bash_profile；此方式兼容性高，适用于早期 macOS 或自定义 shell 场景。
1、下载并解压 Maven 至指定路径，例如：
/Users/yourname/Tools/apache-maven-3.9.6
2、在终端中执行：
vim ~/.bash_profile
3、按 i 进入插入模式，添加以下内容：
export M2_HOME=/Users/yourname/Tools/apache-maven-3.9.6
export PATH=$PATH:$M2_HOME/bin
4、按 Esc 键退出编辑，输入 :wq 保存并退出
5、使配置立即生效：
source ~/.bash_profile
6、执行 mvn -v，若返回有效版本信息，表明环境变量已加载成功。
四、验证 Java 依赖并排查常见失败原因
Maven 运行严格依赖已配置的 JDK；即使 Maven 路径正确，若 java -version 报错或版本过低（低于 JDK 8），mvn 命令仍将失败。
1、检查 Java 是否可用：
java -version
2、若提示 command not found，需先安装并配置 JDK，再确认 JAVA_HOME 是否设置：
echo $JAVA_HOME
3、若 JAVA_HOME 为空或指向错误路径，需在相同配置文件（~/.zshrc 或 ~/.bash_profile）中补充：
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
4、重新加载配置并验证：
source ~/.zshrc && java -version && mvn -v
5、只有 java 和 mvn 均能正常输出版本号，才代表完整链路可用。
五、配置本地仓库与阿里云镜像加速（可选但强烈建议）
默认本地仓库位于 ~/.m2/repository，首次构建项目时依赖下载缓慢；修改 settings.xml 可指定自定义路径并启用国内镜像源提升效率。
1、定位 Maven 解压目录下的 conf/settings.xml 文件，例如：
~/Documents/program/apache-maven-3.9.6/conf/settings.xml
2、用文本编辑器打开，取消注释 <localRepository> 行，并设为绝对路径：
<localRepository>/Users/yourname/.m2/local-repo</localRepository>
3、在 <mirrors> 标签下新增阿里云镜像配置：
<mirror>
<id>aliyun-maven</id>
<mirrorOf>central</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
4、保存文件，无需重启终端，后续 mvn 命令将自动使用新仓库路径与镜像源。此举可显著减少依赖拉取超时或失败概率。
