2025款 MacBook Air (M4芯片) 丝滑配置 Maven 3.9.11 保姆级教程#

搞定了 JDK 21，Java 开发的另一大核心基石就是依赖管理与构建工具 Maven。在搭载 M4 芯片的全新 Mac 上配置 Maven 同样非常简单，只需几步即可打造完美的本地开发环境。这篇博客带你一气呵成完成 Apache Maven 3.9.11 的极速配置。

💡 下载哪个版本最佳？#

Maven 是基于 Java 编写的，天生具备跨平台特性，因此不需要像 JDK 那样严格区分芯片架构。对于 macOS 系统，只需认准这一个官方编译好的二进制压缩包：

版本选择：认准 Binary tar.gz archive。这是 Unix/macOS 系统下最标准的压缩包格式，解压即用，无任何多余的系统垃圾。

Apache Maven 3.9.11 官方归档下载地址： https://archive.apache.org/dist/maven/maven-3/3.9.11/binaries/apache-maven-3.9.11-bin.tar.gz

下载步骤： 极其简单，直接复制上述链接到浏览器地址栏中回车，即可自动开始下载 apache-maven-3.9.11-bin.tar.gz 压缩包到你的 Mac“下载 (Downloads)”文件夹中。

📁 安装到哪个目录最佳？#

在 macOS 上，手动安装的命令行开发工具强烈推荐统一放置在系统级的本地软件目录中。

最佳的安装目录是： /usr/local/

为什么这是最佳目录？

Unix 规范：这是 Unix/macOS 系统专门保留给用户自行安装非系统自带软件的标准目录。
权限与安全：放置在这里的文件受到系统高级别权限保护，不易被意外修改或删除，保证了开发环境的稳定性。

安装过程：这部分操作建议全程在终端 (Terminal) 中通过命令完成，显得极其专业且高效。

打开终端。
解压并移动文件：执行以下命令，将下载好的压缩包直接解压到 /usr/local/ 目录下（执行时会要求输入 Mac 锁屏密码进行授权）：

1
sudo tar -zxvf ~/Downloads/apache-maven-3.9.11-bin.tar.gz -C /usr/local/

解压完成后，Maven 的完整路径即为 /usr/local/apache-maven-3.9.11。

🛠️ 环境变量配置#

我们需要在 macOS 默认的 zsh 终端环境配置文件 ~/.zshrc 中，将刚才解压的 Maven 目录注册到系统的环境变量中。

编辑配置文件：在终端输入以下命令打开配置：

1
nano ~/.zshrc

写入环境变量：在文件末尾，追加以下两行代码（直接指向真实的解压目录）：

1
export MAVEN_HOME=/usr/local/apache-maven-3.9.11
2
export PATH=$MAVEN_HOME/bin:$PATH

保存并退出：按 Control + O 保存，按 Enter 确认，然后按 Control + X 退出编辑器。
使配置生效：在终端执行以下命令，让刚才的修改立即生效：

1
source ~/.zshrc

✅ 验证安装#

最后，让我们确认 Maven 3.9.11 已经完美就绪，并且成功识别到了之前安装的 M4 原生 JDK 21。

在终端中输入：

1
mvn -v

如果你看到类似如下的输出，包含了正确的 Maven 版本、真实的安装路径、Java 版本以及 aarch64 系统架构，那么恭喜你，你的 M4 开发环境已经构建完毕！

1
Apache Maven 3.9.11 (xxxxxxx...)
2
Maven home: /usr/local/apache-maven-3.9.11
3
Java version: 21.0.x, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
4
Default locale: zh_CN, platform encoding: UTF-8
5
OS name: "mac os x", version: "xx.x", arch: "aarch64", family: "mac"

享受丝滑的打包与构建体验吧！

需要我再为你补充一份适用于国内网络环境的 settings.xml 阿里云镜像加速配置模板吗？