Maven安装以及环境变量配置（macOS）

原创于 2025-11-09 02:37:23 发布 · 918 阅读

12 ·

CC 4.0 BY-SA版权

文章标签：

#maven #macos #java

java 专栏收录该内容

2 篇文章

订阅专栏

Maven 是现代 Java 开发的基石，是一个开源的软件项目管理及自动化构建工具。

一、快捷安装流程（HomeBrew安装）

1、命令行安装

直接使用命令行的方式，一键安装。

brew install maven

执行该命令的过程，发生了这么几件事

下载maven依赖包，并安装。
自动配置maven的环境变量

2、验证安装

mvn -version

这个时候，命令行会输出以下内容，则安装成功：

Maven home: /opt/homebrew/Cellar/maven/3.9.9/libexec
Java version: 23.0.2, vendor: Homebrew, runtime: /opt/homebrew/Cellar/openjdk/23.0.2/libexec/openjdk.jdk/Contents/Home
Default locale: zh_CN_#Hans, platform encoding: UTF-8
OS name: "mac os x", version: "14.4.1", arch: "aarch64", family: "mac"

二、手动安装流程

手动安装 maven 环境，有助于我们对 maven 的整体理解。

1、准备前提条件（确保 Java 已安装）

Maven 基于 Java 运行，因此必须先安装 JDK（Java Development Kit）
打开终端（Terminal），输入以下命令检查 Java 是否安装：
```
java -version
```
如果未安装 Java，请下载并安装 Oracle JDK 或 OpenJDK。安装后，配置 JAVA_HOME 环境变量（在 shell 配置文件如 ~/.bash_profile 或 ~/.zshrc 中添加以下行）
```
export JAVA_HOME=$(/usr/libexec/java_home)
export PATH=$JAVA_HOME/bin:$PATH
export CLASS_PATH=$JAVA_HOME/lib
```
保存文件后运行 source ~/.bash_profile（或 source ~/.zshrc）使配置生效

2、下载 Maven 二进制文件：

访问 Apache Maven 官方下载页：https://maven.apache.org/download.cgi。
在 “Files” 部分，找到最新稳定版本的二进制归档文件（例如 apache-maven-3.9.9-bin.tar.gz）
点击 .tar.gz 文件的链接下载（macOS 推荐选择此格式）。

3、下载后的处理：

下载完成后，文件通常位于 ~/Downloads 文件夹。
解压文件到目标目录（例如 /Users/yourusername/DevTools/），使用终端命令：
```
tar -xzvf ~/Downloads/apache-maven-3.9.9-bin.tar.gz -C /Users/yourusername/DevTools/
```
注意：/Users/yourusername/DevTools/，路径名要替换成自己的目标目录，根据习惯不同，有些用户喜欢安装到 /usr/local目录下。
配置 Maven 环境变量：编辑 shell 配置文件（如 ~/.bash_profile 或 ~/.zshrc），添加：
```
export PATH=/Users/yourusername/DevTools/apache-maven-3.9.9/bin:$PATH
```
运行 source ~/.bash_profile（或 source ~/.zshrc）应用更改。

4、高级配置建议（可选）：

设置本地仓库路径：可以在 Maven 的 settings.xml 文件（位于解压目录的 conf 子文件夹）中指定本地仓库位置，例如：
```
<localRepository>/Users/yourusername/DevTools/apache-maven-3.9.9/repository</localRepository>
```
通常情况下，本地仓库的配置不需要改，默认的本地仓库位置为：～/.m2/repository

配置镜像加速下载：建议添加阿里云镜像到 settings.xml，避免从中央仓库下载慢的问题：

<mirror>
  <id>nexus-aliyun</id>
  <mirrorOf>central</mirrorOf>
  <name>Nexus aliyun</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

5、验证安装

mvn -version

这个时候，命令行会输出安装的 maven 版本信息。

三、安装方式的对比

1. 安装流程对比

维度	Homebrew 安装	官网下载手动安装
操作步骤	单行命令：`brew install maven`	需下载压缩包 → 解压 → 手动配置环境变量
依赖处理	自动检查并安装 JDK 等依赖（推荐通过 `brew install openjdk`）	需用户自行安装和配置 JDK
路径管理	自动配置 `/usr/local/bin`，无需手动设 `PATH`	需在 `~/.zshrc` 添加 `export PATH=/path/to/maven/bin:$PATH`
典型耗时	1-3 分钟（依赖网络速度）	5-10 分钟（含手动操作）

2. 版本管理差异

能力	Homebrew	手动安装
版本切换	支持：`brew switch maven@3.8.8`	需手动下载不同版本并更新环境变量
更新机制	一键更新：`brew upgrade maven`	需重新下载压缩包并替换旧版本
版本选择	仅提供最新稳定版（历史版本需 `brew tap` 扩展）	可自由下载任意历史版本

3. 维护与集成

场景	Homebrew 优势	手动安装优势
卸载清理	完全卸载：`brew uninstall maven`	需手动删除文件和清理环境变量
系统集成	与 macOS 系统深度集成，路径标准化	可自定义安装位置（如 `~/DevTools/`）
配置文件	统一管理路径：`/usr/local/etc/maven/settings.xml`	需手动修改解压目录下的 `conf/settings.xml`

4. 适用场景推荐

推荐 Homebrew 安装：
- 追求效率：适合快速部署最新版，避免手动配置。
- 维护便捷：简化更新/卸载流程，降低操作错误风险。
- 新手友好：无需理解环境变量细节。
推荐手动安装：
- 需要特定历史版本（如企业兼容性要求）。
- 需深度自定义配置（如独立仓库路径、镜像源等）。
- 系统无 Homebrew 或网络受限环境。