一、Mac 下 JDK + Maven 安装配置文档（Bash 终端 / Source 生效）

Mac 下 JDK + Maven 安装配置文档（Bash 终端/Source 生效）

本文适配 Bash 终端 （而非默认的 Zsh），全程通过终端命令操作，所有配置均写入 .bash_profile 并通过 source 即时生效，JDK 和 Maven 统一放在 Applications/Java/ 目录管理。

一、环境准备

提前下载对应压缩包到「下载」目录（~/Downloads）：

JDK 17（LTS版）：OpenJDK 17 下载 → 选对应芯片的 .tar.gz 包（如 openjdk-17.0.2_macos-x64_bin.tar.gz）
Maven：Maven 3.9.x 下载 → 选 apache-maven-3.9.12-bin.tar.gz

二、JDK 安装与配置（Bash 终端）

步骤1：解压并移动 JDK

执行以下终端命令（替换版本号为你下载的实际版本）：

bash 复制代码

# 创建统一的 Java 管理目录
mkdir -p /Applications/Java

# 解压 JDK 到临时目录
tar -zxvf ~/Downloads/openjdk-17.0.2_macos-x64_bin.tar.gz -C ~/Downloads/

# 移动解压后的 JDK 到统一目录
mv ~/Downloads/jdk-17.0.2.jdk /Applications/Java/

步骤2：配置 JDK 环境变量（写入 .bash_profile + Source 生效）

bash 复制代码

# 创建/打开 .bash_profile（Bash 核心配置文件）
touch ~/.bash_profile && open ~/.bash_profile

在弹出的文本编辑器中，粘贴以下内容到文件末尾：

bash 复制代码

# JDK 17 环境变量
export JAVA_HOME=/Applications/Java/jdk-17.0.2.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

保存并关闭文件后，终端执行 source 生效：

bash 复制代码

source ~/.bash_profile

步骤3：验证 JDK

bash 复制代码

java -version

输出如下内容即成功：

复制代码

openjdk version "17.0.2" 2022-01-18
OpenJDK Runtime Environment (build 17.0.2+8-86)
OpenJDK 64-Bit Server VM (build 17.0.2+8-86, mixed mode, sharing)

三、Maven 安装与配置（Bash 终端）

步骤1：解压并移动 Maven

bash 复制代码

# 解压 Maven 到临时目录
tar -zxvf ~/Downloads/apache-maven-3.9.12-bin.tar.gz -C ~/Downloads/

# 移动解压后的 Maven 到统一目录
mv ~/Downloads/apache-maven-3.9.12 /Applications/Java/

步骤2：配置 Maven 环境变量（写入 .bash_profile + Source 生效）

bash 复制代码

# 再次打开 .bash_profile
open ~/.bash_profile

在文件末尾追加以下内容：

bash 复制代码

# Maven 环境变量（与 JDK 同目录）
export MAVEN_HOME=/Applications/Java/apache-maven-3.9.12
export PATH=$MAVEN_HOME/bin:$PATH

保存并关闭文件后，终端执行 source 生效：

bash 复制代码

source ~/.bash_profile

步骤3：配置阿里云镜像（加速依赖下载）

bash 复制代码

# 备份原配置文件
cp /Applications/Java/apache-maven-3.9.12/conf/settings.xml /Applications/Java/apache-maven-3.9.12/conf/settings.xml.bak

# 打开 settings.xml 编辑
open /Applications/Java/apache-maven-3.9.12/conf/settings.xml

找到 <mirrors> 标签，替换为以下内容：

xml 复制代码

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

保存并关闭文件即可。

步骤4：验证 Maven

bash 复制代码

mvn -v

输出如下内容即成功：

复制代码

Apache Maven 3.9.12 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: /Applications/Java/apache-maven-3.9.12
Java version: 17.0.2, vendor: Oracle Corporation, runtime: /Applications/Java/jdk-17.0.2.jdk/Contents/Home

步骤5： Maven 配置阿里云镜像的详细步骤

以下是 Bash 终端下 Maven 配置阿里云镜像的详细步骤（纯终端/图形化两种方式，按需选择）：

方式1：纯终端命令配置（无需打开文件）

直接在终端执行以下命令，一键替换 settings.xml 中的镜像配置：

bash 复制代码

# 1. 备份原配置文件（防止出错）
cp /Applications/Java/apache-maven-3.9.12/conf/settings.xml /Applications/Java/apache-maven-3.9.12/conf/settings.xml.bak

# 2. 清空原有 <mirrors> 标签并写入阿里云镜像
sed -i '' '/<mirrors>/,/<\/mirrors>/c\
<mirrors>\
    <mirror>\
        <id>aliyunmaven</id>\
        <mirrorOf>central</mirrorOf>\
        <url>https://maven.aliyun.com/repository/public</url>\
    </mirror>\
</mirrors>' /Applications/Java/apache-maven-3.9.12/conf/settings.xml

方式2：图形化编辑配置（适合新手）

打开 Maven 的 settings.xml 文件：

bash 复制代码

open /Applications/Java/apache-maven-3.9.12/conf/settings.xml

在文件中找到 <mirrors> 标签（通常在文件中间位置）；

清空 <mirrors> 标签内的原有内容，粘贴以下阿里云镜像配置 ：

xml 复制代码

<mirrors>
    <!-- 阿里云Maven镜像 -->
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

按下 Command + S 保存文件，关闭编辑器即可。

验证配置是否生效

执行以下命令，测试 Maven 下载依赖的速度（会自动从阿里云镜像拉取）：

bash 复制代码

# 创建一个临时Maven项目，测试依赖下载
mvn archetype:generate -DgroupId=com.test -DartifactId=test-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

如果下载速度明显变快（几十秒内完成），说明阿里云镜像配置成功。

注意事项

替换命令中的 apache-maven-3.9.12 为你实际的 Maven 版本号；
若提示权限不足，在命令前加 sudo 并输入 Mac 密码；
阿里云镜像支持绝大多数开源依赖，若有特殊依赖（如私有仓库），可在 <mirrors> 中补充其他镜像。

四、核心注意事项

Bash 专属配置 ：所有环境变量均写入 .bash_profile，而非 .zshrc，生效命令为 source ~/.bash_profile；
路径大小写 ：Mac 严格区分大小写，确保 /Applications/Java/ 与配置中路径完全一致；
版本替换 ：命令中的 17.0.2（JDK）、3.9.12（Maven）需替换为你下载的实际版本号；
权限问题 ：若提示「Permission denied」，在命令前加 sudo 并输入 Mac 登录密码。

总结

Bash 终端核心配置文件是 .bash_profile，通过 touch ~/.bash_profile && open ~/.bash_profile 创建/编辑，source ~/.bash_profile 生效；
JDK 和 Maven 统一放在 /Applications/Java/ 目录，便于管理；
每一次修改 .bash_profile 后，必须执行 source ~/.bash_profile 才能让配置即时生效。