Homebrew 安装 Maven 教程（macOS），配置环境变量 + IDEA 适配

简介：使用 brew 一键安装 Maven，不用手动下载解压，配置国内镜像、本地仓库，解决 IDEA 识别 Maven 路径问题。

一、安装 Maven

brew install maven

查看信息：

brew info maven

查看安装路径（M 芯片）

which mvn
# 一般输出：/opt/homebrew/bin/mvn

Maven 真实目录：/opt/homebrew/opt/maven

验证版本：

mvn -v

二、配置环境变量（~/.zshrc）

vim ~/.zshrc

添加：

# Maven
export M2_HOME=/opt/homebrew/opt/maven
export PATH=$PATH:$M2_HOME/bin

生效配置：

source ~/.zshrc

三、修改 settings.xml（重点）

brew 安装的 maven，默认 settings 路径： /opt/homebrew/opt/maven/conf/settings.xml

建议复制一份到用户目录，避免 brew 升级覆盖：

cp /opt/homebrew/opt/maven/conf/settings.xml ~/.m2/settings.xml

然后编辑 ~/.m2/settings.xml，配置阿里云镜像、自定义本地仓库。

示例镜像片段：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

四、IDEA 中配置 Maven（对应你之前的场景）

打开 IDEA 设置： Build, Execution, Deployment → Build Tools → Maven

Maven home path：/opt/homebrew/opt/maven
User settings file：~/.m2/settings.xml
Local repository：自定义仓库路径

五、踩坑点

IDEA 找不到 maven：不要填 /opt/homebrew/bin/mvn，要填上层目录 /opt/homebrew/opt/maven
mvn -v 正常，IDEA 报错：检查 IDEA 的 Runner JDK 和项目 SDK
brew 升级 maven 会覆盖 conf 下的 settings，所以一定要放到～/.m2