Mac用Homebrew搭建Java环境教程

哈喽！今天心血来潮给大家带来了《Mac上用Homebrew搭建Java开发环境》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

brew install openjdk 默认安装 openjdk@21（截至2024年中），路径为/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk，需手动设JAVA_HOME并用/usr/libexec/java_home -v 21注册生效。

brew install openjdk 会安装哪个版本？

Homebrew 默认安装的 openjdk 是最新稳定版（通常是 LTS 或次新 LTS），比如目前是 openjdk@21。它不会安装系统自带的 /usr/bin/java 对应的 Apple JDK，也不会自动软链接到 /usr/local/bin/java。

关键点在于：Homebrew 安装的 JDK 是“孤立”的，不参与 macOS 的 java_home 自动发现，除非你手动配置。

• 运行 brew install openjdk 实际触发的是 openjdk@21（截至 2024 年中）
• 安装路径类似：/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk（Apple Silicon）或 /usr/local/opt/openjdk@21/libexec/openjdk.jdk（Intel）
• brew link openjdk@21 不会执行成功 —— Homebrew 明确禁止自动 link JDK，避免覆盖系统行为

如何让 java -version 和 mvn 正确识别 Homebrew JDK？

必须手动设置 JAVA_HOME，否则 java 命令仍可能调用系统默认（甚至报错“no Java runtime present”）。

推荐做法是写入 shell 配置（~/.zshrc 或 ~/.zprofile），并使用 /usr/libexec/java_home 动态定位：

export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH

注意：/usr/libexec/java_home -v 21 能识别 Homebrew 安装的 JDK，前提是该 JDK 已被 macOS 的 Java Config 框架注册 —— Homebrew openjdk@21 安装后会自动执行注册脚本（在 post_install 中调用 sudo /usr/libexec/PlistBuddy 写入 /Library/Java/JavaVirtualMachines/ 下的 plist），所以通常开箱可用。

• 验证是否生效：echo $JAVA_HOME 应输出类似 /opt/homebrew/Cellar/openjdk@21/21.0.3/libexec/openjdk.jdk/Contents/Home
• Maven、Gradle、IntelliJ 都依赖 JAVA_HOME 或 PATH 中的 java，设好后无需额外配置
• 如果 java_home -v 21 找不到，检查 ls /Library/Java/JavaVirtualMachines/ 是否有 openjdk-21.jdk 目录；没有则需手动 symlink 或重装

同时管理多个 JDK（如 17 + 21）时怎么切换？

靠 /usr/libexec/java_home 切换最可靠，不要手动改 JAVA_HOME 硬编码路径。

可以定义快捷函数写进 ~/.zshrc：

jdk() {
  version=$1
  export JAVA_HOME=$(/usr/libexec/java_home -v "$version")
  export PATH=$JAVA_HOME/bin:$PATH
  java -version
}

然后终端里直接运行：jdk 17 或 jdk 21 即可即时切换。

• java_home -V（大写 V）列出所有已注册 JDK，包括 Homebrew 和 SDKMAN! 安装的（只要注册过）
• Homebrew JDK 注册名通常是 openjdk-21.jdk，对应版本字符串为 21，不是 21.0.3
• 不同 JDK 的 javac 版本和 java 运行时行为可能不一致，尤其涉及 --enable-preview 或 SecurityManager 移除等特性

为什么 javac 编译正常但运行时报 NoClassDefFoundError？

常见于未正确设置 JAVA_HOME 导致编译与运行用了不同 JDK —— 比如 javac 来自 Homebrew JDK，而 java 命令仍指向旧版或系统 stub。

排查步骤：

• 分别运行 which java 和 which javac，确认二者路径前缀一致（都应在 $JAVA_HOME/bin 下）
• 运行 java -XshowSettings:properties -version 2>&1 | grep java.home，看实际加载的 java.home 是否与 $JAVA_HOME 一致
• 如果用 IDE（如 IntelliJ），它可能忽略 shell 的 JAVA_HOME，需在 Preferences → Build → Gradle/Compiler → Java Compiler 中显式指定 Project SDK

Homebrew JDK 默认启用 --illegal-access=permit（仅限 JDK 17），但 JDK 21 已彻底移除反射非法访问支持，这类错误更易暴露底层依赖问题。

理论要掌握，实操不能落！以上关于《Mac用Homebrew搭建Java环境教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！