一、下载Apache Maven 3.6.3
Apache Maven 3.6.3 官方下载链接：
二进制压缩包（推荐）:
- ZIP格式: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip
- TAR.GZ格式: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
校验文件:
- MD5: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip.md5
- SHA512: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip.sha512
macOS 校验命令:
# MD5校验
md5 apache-maven-3.6.3-bin.zip
# SHA512校验
shasum -a 512 apache-maven-3.6.3-bin.zip
二、安装
我来为您详细说明在 Mac 上安装和配置 Maven 3.6.3 的完整步骤：
1. 解压安装包
# 进入下载目录
cd ~/Downloads
# 解压下载的文件到 /usr/local 目录
sudo tar -xzvf apache-maven-3.6.3-bin.tar.gz -C /usr/local
2. 配置环境变量
选择以下任一方式配置环境变量：
方式一：使用 .zshrc（如果您使用的是 zsh shell）
如果您下载的是 .zip 格式的文件，解压命令会不同。以下是在 Mac 上解压 .zip 文件的步骤：
1. 使用命令行解压
# 进入下载目录
cd ~/Downloads
# 解压 zip 文件到 /usr/local 目录
unzip apache-maven-3.6.3-bin.zip -d /usr/local
如果提示权限问题，需要加 sudo：
sudo unzip apache-maven-3.6.3-bin.zip -d /usr/local
2. 使用图形界面解压（更简单的方式）
- 在 Finder 中找到下载的 zip 文件
- 双击文件进行解压
- 解压后将文件夹移动到 /usr/local 目录：
sudo mv ~/Downloads/apache-maven-3.6.3 /usr/local/
3.解压完成后，继续按前面提到的步骤配置环境变量
- 打开终端配置文件：
vim ~/.zshrc # 如果使用的是 zsh
# 或
vim ~/.bash_profile # 如果使用的是 bash
- 添加环境变量：
export M2_HOME=/usr/local/apache-maven-3.6.3
export PATH=$PATH:$M2_HOME/bin
- 使配置生效：
source ~/.zshrc # 如果使用的是 zsh
# 或
source ~/.bash_profile # 如果使用的是 bash
- 验证安装：
mvn -v
提示：如果不确定自己使用的是什么 shell，可以使用以下命令查看：
echo $SHELL
方式二：使用 .bash_profile（如果您使用的是 bash shell）
# 打开配置文件
vim ~/.bash_profile
# 添加以下内容
export M2_HOME=/usr/local/apache-maven-3.6.3
export PATH=$PATH:$M2_HOME/bin
# 使配置生效
source ~/.bash_profile
3. 验证安装
# 检查 Maven 版本
mvn -v
应该看到类似下面的输出：
Apache Maven 3.6.3
Maven home: /usr/local/apache-maven-3.6.3
Java version: 1.8.0_xxx, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.xxx.jdk/Contents/Home
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.15.7", arch: "x86_64", family: "mac"
4. 配置 Maven 设置（可选但推荐）
# 创建 Maven 配置目录
mkdir -p ~/.m2
# 复制默认配置文件
cp /usr/local/apache-maven-3.6.3/conf/settings.xml ~/.m2/
常用配置修改（编辑 ~/.m2/settings.xml）：
<settings>
<!-- 配置本地仓库路径 -->
<localRepository>${user.home}/.m2/repository</localRepository>
<!-- 配置阿里云镜像 -->
<mirrors>
<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>
</settings>
5. 可能遇到的问题及解决方案
问题1：权限问题
# 如果遇到权限问题，执行：
sudo chmod -R 755 /usr/local/apache-maven-3.6.3
问题2：找不到 JAVA_HOME
确保已正确安装 JDK 并配置 JAVA_HOME：
# 在 .zshrc 或 .bash_profile 中添加
export JAVA_HOME=$(/usr/libexec/java_home)
6. 使用建议
-
本地仓库位置：
- 默认在
~/.m2/repository - 可以通过 settings.xml 修改位置
- 默认在
-
配置文件优先级：
- 用户级配置：
~/.m2/settings.xml - 全局配置：
$M2_HOME/conf/settings.xml
- 用户级配置：
-
内存设置：
# 如需设置 Maven 运行内存，可添加到环境变量
export MAVEN_OPTS="-Xmx2048m -XX:MaxPermSize=512m"
7. 验证全部配置
# 测试一个简单的 Maven 命令
mvn help:system
如果以上命令正常执行，说明 Maven 安装和配置都已完成。
提醒：
- Maven 3.6.3 是一个相对稳定的版本，被广泛使用
- 建议下载后进行文件完整性校验
需要注意的是，虽然有更新的 Maven 版本(如 3.9.x)，但 3.6.3 版本依然是很多企业项目的首选版本，因为它经过了充分的验证和实践。
