Adoptium JDK 21 在 macOS Monterey 上需配置 JAVA_HOME 和 PATH：先确认安装（/usr/libexec/java_home -V），再根据 shell 类型编辑 ~/.zshrc 或 ~/.bash_profile，写入 export JAVA_HOME=$(/usr/libexec/java_home -v 21) 和 export PATH=$JAVA_HOME/bin:$PATH，执行 source 命令生效，最后验证 java -version、javac -version 和 echo $JAVA_HOME 三者一致。
在 macOS Monterey 系统上运行 Java 项目或构建工具（如 Maven、Gradle）时，若终端提示 command not found: java 或 javac 不可用，说明 Adoptium JDK 21 已安装但环境变量未生效——这通常是因为 JAVA_HOME 未正确写入 shell 配置文件，或 PATH 未将 JDK 的 bin 目录前置。
确认 Adoptium JDK 21 是否已安装
打开终端，执行以下命令：
/usr/libexec/java_home -V
若输出中包含类似 21.0.4 (x86_64) "Eclipse Temurin" - /Library/Java/JavaVirtualMachines/jdk-21.0.4.jdk/Contents/Home 的条目，说明 Adoptium JDK 21 已成功安装；若无任何 21.x 版本显示，请先前往 https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba 下载对应芯片架构（Apple Silicon 选 aarch64，Intel 选 x64）的 .dmg 安装包并完成安装。
确定当前 shell 类型并编辑配置文件
Monterey 默认使用 zsh，但部分用户可能仍为 bash。先确认：
echo $SHELL
→ 若输出 /bin/zsh，则编辑 ~/.zshrc；若输出 /bin/bash，则编辑 ~/.bash_profile。
执行对应命令打开编辑器：
zsh 用户：nano ~/.zshrc；bash 用户：nano ~/.bash_profile。
⚠️ 注意：不要编辑 .zshenv 或 .profile，它们加载时机早于用户级配置，可能导致 JAVA_HOME 被后续配置覆盖。
写入 JAVA_HOME 和 PATH（推荐动态方式）
在 nano 编辑器中，将光标移至文件末尾，添加以下两行：
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH
这一步必须严格按顺序：先定义 JAVA_HOME，再将其 bin 目录置于 PATH 最前端。如果把 $JAVA_HOME/bin 放在 $PATH 后面，系统可能优先调用旧版本或系统自带的 java，导致 【javac -version 与 java -version 输出不一致】。
按 Ctrl+O 保存 → 回车确认文件名 → Ctrl+X 退出。
立即加载新配置
执行：
source ~/.zshrc（zsh 用户）或 source ~/.bash_profile（bash 用户）
该命令会重新读取配置文件，使 JAVA_HOME 和 PATH 生效。不执行此步，新开终端才生效，当前终端仍不可用。
验证三重一致性
依次运行以下三条命令，全部通过才算配置成功：
java -version → 应输出含 21. 开头的版本号及 "Eclipse Temurin" 厂商标识
javac -version → 输出版本号必须与上一条完全一致（例如都是 21.0.4）
echo $JAVA_HOME → 输出路径应与 /usr/libexec/java_home -v 21 返回值完全相同，且结尾为 /Contents/Home
