macOS安装配置Maven有四种方法：一、用Homebrew一键安装并自动配置PATH；二、官网下载tar.gz包，手动解压并配置M2_HOME与PATH；三、修改conf/settings.xml自定义本地仓库路径及添加阿里云镜像源；四、在IntelliJ IDEA中指定Maven路径、settings.xml和本地仓库以确保配置同步。
如果您在 macOS 系统中需要使用 Maven 进行 Java 项目构建与依赖管理，但尚未完成安装与基础配置，则可能是由于未正确设置环境变量或安装路径未被系统识别。以下是针对 Mac 系统的多种安装与配置方法：
一、通过 Homebrew 一键安装
Homebrew 是 macOS 上主流的包管理工具，可自动完成 Maven 的下载、解压与环境变量配置，适合希望快速启用 Maven 的用户。
1、打开终端应用程序，执行命令安装 Homebrew（若尚未安装）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、安装完成后，运行以下命令安装 Maven：brew install maven
3、安装过程结束后，系统将自动将 mvn 命令添加至 PATH，无需手动编辑配置文件。
4、验证安装是否成功：mvn -v
5、若终端输出 Maven 版本、Java 版本及 M2_HOME 路径信息，则表示安装与基础环境已就绪。
二、官网下载并手动配置环境变量
该方法提供对 Maven 安装路径、版本及配置文件的完全控制，适用于需指定特定版本或自定义本地仓库位置的场景。
1、访问 Apache Maven 官网下载页面：https://maven.apache.org/download.cgi，选择最新稳定版的 Binary tar.gz archive 文件下载。
2、双击下载的 apache-maven-*.tar.gz 文件完成解压，或将终端切换至下载目录后执行：tar -xzf apache-maven-*.tar.gz
3、将解压后的 apache-maven-* 文件夹移动至目标路径，例如：mv apache-maven-* ~/Documents/program/maven
4、确认当前 shell 配置文件类型：macOS Catalina 及更新系统默认使用 zsh，对应配置文件为 ~/.zshrc；旧版系统可能使用 bash，对应 ~/.bash_profile。在终端中执行：echo $SHELL
5、根据上一步结果，用文本编辑器打开对应文件，例如：vim ~/.zshrc
6、按 i 进入插入模式，添加以下两行（路径需替换为实际 Maven 解压路径）：export M2_HOME=/Users/$(whoami)/Documents/program/maven/apache-maven-*export PATH=$PATH:$M2_HOME/bin
7、按 Esc 键退出编辑，输入 :wq 保存并退出 Vim。
8、使配置立即生效：source ~/.zshrc
9、执行 mvn -v 检查输出，确认版本信息与 Java 路径显示正常。
三、配置 Maven 本地仓库与阿里云镜像源
默认本地仓库位于 ~/.m2/repository，易与其他用户或项目产生路径冲突；中央仓库在国外，国内下载依赖缓慢。配置自定义仓库路径与国内镜像可显著提升构建效率。
1、进入 Maven 安装目录下的 conf 子目录：cd ~/Documents/program/maven/apache-maven-*/conf
2、复制原始配置模板（如不存在则新建）：cp settings.xml settings.xml.bak
3、编辑 settings.xml：vim settings.xml
4、在 <settings> 标签下，找到注释掉的 <localRepository> 行，取消注释并修改为绝对路径：<localRepository>/Users/$(whoami)/Documents/program/maven/repo</localRepository>
5、在 <mirrors> 标签内（若不存在则手动添加该标签），插入阿里云公共镜像配置：<mirror><id>nexus-aliyun</id><mirrorOf>central</mirrorOf><name>Nexus aliyun</name><url>https://maven.aliyun.com/repository/public</url></mirror>
6、保存文件并退出编辑器。
7、执行 mvn help:system 触发一次基础依赖拉取，观察日志中是否使用了 https://maven.aliyun.com 地址，确认镜像生效。
四、在 IntelliJ IDEA 中关联 Maven
IDEA 默认使用内置 Maven 实例，但为确保与系统级配置一致（如本地仓库、镜像源、JDK 版本），需显式指向已安装的 Maven 目录。
1、启动 IntelliJ IDEA，进入 Preferences（偏好设置）（macOS 快捷键 Cmd + ,）。
2、在左侧导航栏中依次展开 Build, Execution, Deployment > Build Tools > Maven。
3、在 Maven home path 选项中，点击右侧文件夹图标，选择您手动安装的 Maven 根目录（例如：/Users/xxx/Documents/program/maven/apache-maven-*）。
4、确认 User settings file 指向已修改的 conf/settings.xml，而非 IDEA 自带副本。
5、确认 Local repository 显示路径与 settings.xml 中配置的 <localRepository> 一致。
6、点击 Apply 后，新建 Maven 项目时将自动应用所设仓库与镜像策略。
