macOS上Java环境配置需先下载安装JDK（推荐Temurin或Oracle LTS版），再通过zshrc配置JAVA_HOME与PATH，最后验证java/javac版本及路径。
如果您在 macOS 系统上运行 Java 应用程序或开发 Java 项目，但终端提示 command not found: java 或 java version not recognized，则说明系统尚未正确安装 JDK 或环境变量未配置。以下是完成 MAC 上 Java 环境安装与 JDK 环境变量配置的完整操作流程：
一、下载并安装 JDK
macOS 不再预装 Oracle JDK，需手动获取官方支持的 JDK 版本。推荐使用 LTS 版本（如 JDK 17 或 JDK 21），确保兼容性与长期维护支持。
1、访问 https://adoptium.net/（Eclipse Temurin 官方站点）或 https://www.oracle.com/java/technologies/javase/jdk-downloads.html；
2、选择适用于 macOS 的 ARM64（Apple Silicon） 或 x64（Intel） 对应架构的 .dmg 安装包；
立即学习“Java免费学习笔记（深入）”；
3、双击下载的 .dmg 文件，运行安装向导，按提示完成 JDK 安装；
4、安装完成后，在终端执行 /usr/libexec/java_home -V，确认 JDK 路径已注册并列出版本信息。
二、配置 JAVA_HOME 环境变量（zsh 方式）
macOS Catalina 及后续版本默认使用 zsh 作为登录 shell，环境变量需写入 ~/.zshrc 文件，使每次启动终端时自动加载。
1、在终端中执行 nano ~/.zshrc 打开配置文件；
2、在文件末尾新增一行：export JAVA_HOME=$(/usr/libexec/java_home -v 17)（将 “17” 替换为您实际安装的 JDK 主版本号，例如 21）；
3、另起一行添加：export PATH=$JAVA_HOME/bin:$PATH；
4、按 Control + O 保存，Control + X 退出 nano；
5、执行 source ~/.zshrc 立即生效配置。
三、配置 JAVA_HOME 环境变量（shell 脚本方式）
为避免硬编码版本号导致升级后失效，可采用动态解析方式读取最新可用 JDK，提升配置鲁棒性。
1、执行 echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshrc；
2、执行 echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc；
3、执行 source ~/.zshrc 加载变更；
4、验证是否生效：输入 echo $JAVA_HOME，输出应为类似 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home 的路径。
四、验证 Java 安装与环境变量
完成上述任一配置方式后，必须通过多条命令交叉验证，确保 java、javac 命令可调用且指向正确 JDK 实例。
1、执行 java -version，确认输出包含已安装 JDK 的版本号及厂商信息；
2、执行 javac -version，确认编译器版本与 java 一致；
3、执行 which java，输出应为 /usr/bin/java（该路径由系统符号链接指向 $JAVA_HOME/bin/java）；
4、执行 ls -l $(which java)，确认其软链接最终指向 $JAVA_HOME/bin/java。
五、切换多版本 JDK（可选）
当系统中存在多个 JDK 版本时，可通过 /usr/libexec/java_home 工具快速切换默认版本，无需反复修改配置文件。
1、列出所有已安装 JDK：/usr/libexec/java_home -V；
2、查看当前默认路径：/usr/libexec/java_home；
3、临时切换至指定版本（当前终端有效）：export JAVA_HOME=$(/usr/libexec/java_home -v 21)；
4、永久切换需编辑 ~/.zshrc 中的 JAVA_HOME 行，并重新 source。
