Homebrew 安装 Maven + 配置阿里云 Maven 镜像源

一、Homebrew 安装 Maven

bash

运行

# 更新brew索引
brew update
# 安装maven
brew install maven
# 验证安装
mvn -v

二、找到 Maven 配置文件 settings.xml

方式 1：brew 安装默认路径

bash

运行

# 查看maven安装目录
brew info maven
# 通常主配置文件路径
/usr/local/Cellar/maven/xxx/libexec/conf/settings.xml
# M1/M2/M3 芯片路径
/opt/homebrew/Cellar/maven/xxx/libexec/conf/settings.xml

不建议直接修改安装目录内的配置，推荐使用用户级配置（永久生效、brew 升级不会覆盖）：

bash

运行

# 创建用户maven配置目录
mkdir -p ~/.m2
# 复制默认配置到用户目录
cp $(mvn -v | grep "Maven home" | awk '{print $3"/conf/settings.xml"}') ~/.m2/

三、编辑 ~/.m2/settings.xml 加入阿里云镜像

打开文件：

bash

运行

vim ~/.m2/settings.xml

找到 <mirrors> 标签，在里面粘贴阿里云镜像配置：

xml

<mirrors>
    <!-- 阿里云中央仓库镜像 -->
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>

    <!-- 可选：阿里云Spring仓库镜像 -->
    <mirror>
        <id>aliyun-spring</id>
        <mirrorOf>spring</mirrorOf>
        <name>阿里云Spring仓库</name>
        <url>https://maven.aliyun.com/repository/spring</url>
    </mirror>
</mirrors>

完整最简可用 settings.xml 参考

xml

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">

  <localRepository>${user.home}/.m2/repository</localRepository>

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

</settings>

四、测试镜像是否生效

bash

运行

# 随便拉一个依赖测试下载
mvn dependency:get -DgroupId=org.slf4j -DartifactId=slf4j-api -Dversion=1.7.36

日志里出现 aliyun 域名即配置成功。

补充：IDEA 内 Maven 关联该配置

1. IDEA 打开 Settings -> Build, Execution, Deployment -> Build Tools -> Maven
2. User settings file 勾选 ~/.m2/settings.xml
3. Apply 即可项目全局使用阿里云镜像。

卸载 Maven（如需）

bash

运行

brew uninstall maven
# 清理缓存
brew cleanup maven