Mac 多 JDK 怎么管理：Homebrew、jenv、JAVA_HOME 和项目版本边界

Mac 上同时存在 JDK 8、JDK 11、JDK 17、JDK 21 很常见。老项目要跑 JDK 8，新项目要 JDK 17，命令行、IDE、Maven、Gradle 又各自可能读不同配置。真正麻烦的不是安装，而是知道当前项目到底在用哪个 Java。

先看系统里有哪些 JDK

macOS 可以用 /usr/libexec/java_home 看已安装的 JDK：

/usr/libexec/java_home -V

临时切换到 JDK 17：

export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH="$JAVA_HOME/bin:$PATH"
java -version

这适合临时验证，但不适合长期写进所有脚本。长期脚本里硬编码本机路径，换机器或升级 JDK 后很容易坏。

安装方式尽量统一

JDK 可以从官网、Homebrew、SDKMAN、IDE 自带运行时等多个渠道安装。个人机器建议收敛一种主安装方式，减少路径混乱。

如果使用 Homebrew，可以安装 Temurin 或 Zulu：

brew install --cask temurin@17
brew install --cask zulu@17

安装后再用 java_home -V 确认系统是否识别。不要只看 brew list，因为能安装不代表当前 shell 已经在用。

项目级版本要落在仓库里

团队或个人长期维护项目，最好在项目根目录放 .java-version，写明期望 JDK：

17

Maven 项目再用 Enforcer 锁住版本，避免本机 Java 版本漂移：

<requireJavaVersion>
  <version>[17,18)</version>
</requireJavaVersion>

这样新机器拉项目时，不需要猜“这个项目到底该用 Java 8 还是 17”。

jenv 适合做目录级切换

如果经常在多个项目之间切换，jenv 比手写 export JAVA_HOME 更适合。思路是把多个 JDK 注册给 jenv，再在项目目录设置 local 版本。

jenv add "$(/usr/libexec/java_home -v 17)"
jenv versions
jenv local 17

注意：jenv 控制的是 shell 环境。IDE、CI、Docker 镜像仍要单独配置。不要以为命令行切了 JDK，IDE 就一定同步。

Maven 和 Gradle 也要确认

排查 Java 版本时，不只看：

java -version

还要看：

mvn -version
gradle -version

Maven 输出里会显示运行 Maven 的 Java 版本。如果 java -version 是 17，但 mvn -version 显示 8，说明 Maven 进程读到的 JAVA_HOME 和 shell 预期不一致。

IDE 里有两个版本概念

IDEA 里至少有两处要看：

• Project SDK：项目编译和索引用。
• Maven/Gradle JVM：构建工具运行用。

如果 Project SDK 是 17，但 Maven Runner 用 8，编译结果仍可能报“class file version 不支持”或依赖解析异常。处理旧项目时，先把这两处和命令行版本对齐。

最后抓住一句话

Mac 多 JDK 管理的关键是“项目声明版本、命令行确认版本、构建工具对齐版本、IDE 单独检查”。只要这四层一致，JDK 切换就不再靠记忆和运气。