若终端无法识别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

Lingxi · Webhook Dispatcher with GitHub API Fallback

智能 Webhook 分发器，支持 GitHub API 回退机制。当 Git 推送失败时，自动路由至 GitHub Contents API。支持重试逻辑、del…

下载

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、用文本编辑器打开，取消注释 行，并设为绝对路径：
/Users/yourname/.m2/local-repo

3、在 标签下新增阿里云镜像配置：

  aliyun-maven
  central
  Aliyun Maven
  https://maven.aliyun.com/repository/central

4、保存文件，无需重启终端，后续 mvn 命令将自动使用新仓库路径与镜像源。此举可显著减少依赖拉取超时或失败概率。