Mac上配置Maven需完成安装、环境变量、本地仓库及阿里云镜像四步：一、Homebrew一键安装并验证；二、手动下载解压后配置M2_HOME与PATH；三、修改settings.xml指定localRepository路径；四、在mirrors节点添加阿里云镜像URL。
如果您在Mac系统上需要使用Maven进行Java项目构建，但尚未完成安装与基础环境配置，则可能是由于未正确设置环境变量、本地仓库路径或远程镜像源。以下是完成Maven安装、环境变量配置、本地仓库设定及阿里云镜像配置的具体操作步骤：
一、通过Homebrew一键安装Maven
该方法无需手动解压与路径配置，适合希望快速启用Maven且系统已安装Homebrew的用户。Homebrew会自动处理二进制文件部署与PATH注入。
1、在终端中执行安装命令：
brew install maven
2、验证安装结果：
mvn -v
3、确认Maven实际安装路径：
brew --prefix maven
4、如需快速打开其安装目录，在访达中按Command + Shift + G，粘贴上一步输出的路径后回车。
二、手动下载并配置Maven环境变量
适用于需指定特定版本（如3.6.1、3.8.5等）、规避IDEA兼容性问题，或无法使用Homebrew的场景。配置核心是将Maven的bin目录写入shell启动文件，使mvn命令全局可用。
1、访问Apache Maven官网或清华镜像站下载tar.gz格式的binaries包：
https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/
2、解压后将apache-maven-x.x.x文件夹移至稳定路径，例如：
/usr/local/apache-maven-3.8.5
3、根据当前Shell类型编辑对应配置文件：
若使用zsh（macOS Catalina及以后默认）：vim ~/.zshrc
若使用bash（旧系统）：vim ~/.bash_profile
4、在文件末尾添加以下两行（请将路径替换为您的实际解压路径）：
export M2_HOME=/usr/local/apache-maven-3.8.5
export PATH=$PATH:$M2_HOME/bin
5、使配置立即生效：
source ~/.zshrc 或 source ~/.bash_profile
6、验证环境变量是否生效：
echo $M2_HOME 与 mvn -v 应分别返回路径与版本信息
三、配置本地仓库路径
默认本地仓库位于用户主目录下的~/.m2/repository，但该路径可能受限于磁盘空间或权限策略。自定义路径可提升管理灵活性与I/O性能。
1、打开Maven配置文件：
vim /usr/local/apache-maven-3.8.5/conf/settings.xml
2、在
3、取消注释并修改为绝对路径，例如：
4、确保目标目录存在且当前用户具有读写权限：
mkdir -p /Users/yourname/MavenRepo
chmod 755 /Users/yourname/MavenRepo
5、保存退出后，首次执行mvn clean compile时将自动初始化该目录结构
四、配置阿里云Maven镜像仓库
国内直连Maven Central常因网络延迟或连接失败导致依赖下载超时。配置阿里云镜像可显著提升依赖解析速度与成功率，且无需修改项目pom.xml。
1、再次打开settings.xml文件：
vim /usr/local/apache-maven-3.8.5/conf/settings.xml
2、定位到
3、在
4、注意：url必须使用https://maven.aliyun.com/repository/public（2026年有效地址），旧版http协议已停用
5、保存文件后，执行mvn help:effective-settings可验证镜像是否被激活
五、显示并访问隐藏的.m2目录
本地仓库默认位于~/.m2，该目录以点号开头，在Finder中默认不可见。直接操作该目录有助于排查缓存冲突、清理损坏jar或手动导入离线依赖。
1、在终端中执行命令以全局显示所有隐藏文件：
defaults write com.apple.finder AppleShowAllFiles TRUE
2、强制重启Finder进程使其生效：
killall Finder
3、此时在访达中进入用户主目录，即可看到.m2文件夹
4、若后续需恢复隐藏状态，将TRUE改为FALSE并再次执行killall Finder
