Mac配Java环境关键是确保java/javac命令生效且版本正确，需安装JDK、用/usr/libexec/java_home -V确认路径、设JAVA_HOME并重载~/.zshrc，再验证版本及IDE配置。
Mac 上配 Java 环境，核心不是“装 JDK”，而是确保 java、javac 命令能被终端识别，且版本符合项目要求。系统自带的 Java（如旧版 JDK 6）早已弃用，必须手动安装并正确配置 JAVA_HOME。
确认当前 Java 状态与卸载残留
很多人卡在第一步：以为装了 JDK 就万事大吉，其实 /usr/bin/java 可能仍指向系统旧版本或 stub（占位程序），而新 JDK 安装后未生效。
- 运行
which java和which javac—— 若返回空或指向/usr/bin/，说明命令未走新 JDK - 运行
/usr/libexec/java_home -V查看所有已安装 JDK 路径（注意大小写：是-V，不是-v） - 若看到多个版本（如 jdk-17.jdk、jdk-21.jdk），但
java -version显示的仍是旧版，说明JAVA_HOME未设或设错 - 无需手动删系统旧 JDK；macOS 不允许删除
/System/Library/Java/下内容，也不建议动它 —— 正确做法是绕过它
安装 JDK 并验证路径
推荐从 Eclipse Temurin 或 Oracle 官网 下载 macOS ARM64（Apple Silicon）或 x64（Intel）对应架构的 .dmg。安装后 JDK 默认路径为：
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
注意：jdk-21.jdk 是文件夹名，不同版本会变（如 temurin-17.jdk），务必用 /usr/libexec/java_home -V 确认实际名称。
立即学习“Java免费学习笔记（深入）”；
- 不要复制粘贴网上泛用的路径，比如
/Library/Java/JavaVirtualMachines/jdk1.8.0_291.jdk—— 这种带点号和下划线的命名只存在于极老版本，新版全是短横线 - 安装完成后，
ls /Library/Java/JavaVirtualMachines/应能看到对应 .jdk 文件夹 - 直接运行
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home/bin/java -version应输出正确版本，这是验证安装成功的最可靠方式
设置 JAVA_HOME 并使其全局生效
Mac 的 shell 启动文件取决于你用的是 zsh（macOS Catalina 及以后默认）还是 bash。绝大多数人用的是 zsh，所以改 ~/.zshrc。
- 在
~/.zshrc末尾添加：export JAVA_HOME=$(/usr/libexec/java_home -v 21)
（把21换成你要的主版本号，如17） - 执行
source ~/.zshrc重载配置 - 立即验证：
echo $JAVA_HOME应输出完整路径，java -version和javac -version应一致且匹配预期 - 如果用了 IDE（如 IntelliJ），需重启 IDE 或在偏好设置里手动指定 SDK 路径 —— IDE 不读 shell 的
JAVA_HOME，除非显式配置
常见失效场景与排查重点
环境看似配好，但 Maven 编译失败、Gradle 报 Unsupported class file major version、或 VS Code Java 扩展不识别，往往不是 JDK 没装，而是路径没对齐。
-
mvn -v显示的 Java 版本 ≠java -version？检查MAVEN_OPTS或~/.mavenrc是否硬编码了旧JAVA_HOME - 终端里
java -version正确，但 VS Code 终端里不对？VS Code 默认启动非登录 shell，可能没加载~/.zshrc—— 在 VS Code 设置里开启terminal.integrated.inheritEnv，或在settings.json中加"terminal.integrated.env.osx": {"JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home"} -
/usr/libexec/java_home -v 17返回 “No Java runtime present”？说明该版本根本没安装，或安装时权限异常（常见于用sudo错误安装导致属主错误）—— 重装即可，别手动 chown
最关键的细节：Mac 的 Java 环境是否生效，永远以 java -version 和 javac -version 输出为准，而不是看图形化安装器有没有弹出完成提示。路径、shell 配置、IDE 独立配置，这三者必须各自对齐，缺一不可。
