最推荐 macOS 上通过 Homebrew 明确安装指定版本 OpenJDK（如 brew install openjdk@17），而非模糊的 brew install java；需用 /usr/libexec/java_home -v 17 动态设置 JAVA_HOME，并将 $JAVA_HOME/bin 置于 PATH 前端以确保 javac 等命令可用。
靠谱，而且是 macOS 上最推荐的 Java 安装方式之一 —— 但“靠谱”的前提是：你清楚 brew install java 和 brew install openjdk@17 的本质区别，以及 Homebrew 不会自动帮你配好 JAVA_HOME。
为什么 brew install java 看似方便却容易翻车
Homebrew 官方公式库（homebrew-core）中确实存在一个叫 java 的别名包，但它只是指向最新稳定版 OpenJDK 的软链接（目前为 openjdk@21）。问题在于：
- 它不显示版本号，
brew search java也搜不到它，新手会误以为“没装上”或“装错了” - 一旦上游更新，
brew upgrade可能悄无声息地把你的 JDK 从 17 升到 21，导致mvn compile报Unsupported class file major version - 它不提供版本管理能力，无法共存多个 JDK，也不支持
jenv自动识别
真正可控、可追溯、被社区广泛验证的方式，是明确指定版本安装，比如：
brew install openjdk@17
这个包路径清晰、升级受控、文档完整，且所有主流 IDE（IntelliJ、VS Code）都能自动识别其路径。
立即学习“Java免费学习笔记（深入）”；
/opt/homebrew/opt/openjdk@17 和 /usr/libexec/java_home -v 17 到底该信谁
Homebrew 安装的 JDK 路径是固定的：/opt/homebrew/opt/openjdk@17（Apple Silicon）或 /usr/local/opt/openjdk@17（Intel），但它只是一个符号链接，真实 JDK 根目录在 libexec/openjdk.jdk/Contents/Home。而 macOS 原生的 /usr/libexec/java_home 是系统级工具，它扫描所有已注册的 JDK（包括手动安装、Android Studio 自带、甚至 Oracle JDK），并返回最匹配的路径。
所以——
- 写死路径（如
export JAVA_HOME="/opt/homebrew/opt/openjdk@17"）会导致后续切换 JDK 失效 - 用
export JAVA_HOME=$(/usr/libexec/java_home -v 17)才是正确姿势：它动态定位、兼容多版本、且与系统其他 Java 工具链（如keytool、jpackage）行为一致
验证是否生效，只需运行：
echo $JAVA_HOME
java -version
/usr/libexec/java_home -V
装完 openjdk@17 后，javac 找不到？不是漏装，是 PATH 没导对
Homebrew 安装后不会自动修改 shell 的 PATH，这是设计使然（避免污染环境）。常见错误现象：
-
java -version成功，但javac -version报command not found -
echo $JAVA_HOME有输出，但$JAVA_HOME/bin/javac实际不存在
原因：Homebrew 的 JDK 二进制实际在 $JAVA_HOME/bin 下，但你只加了 $JAVA_HOME，没加 $JAVA_HOME/bin 到 PATH。
正确做法（以 zsh 为例）：
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
注意顺序：$JAVA_HOME/bin 必须放在 $PATH 前面，否则可能调用到系统残留的旧版 javac。
最容易被忽略的一点：Homebrew 安装的 OpenJDK 默认不含 jmc（Java Mission Control）和部分企业级诊断工具；如果你依赖 jcmd、jstat 等命令，它们都在 bin/ 下，只要 PATH 配对就全可用 —— 但别指望图形化 JMC，得单独下载 Eclipse Temurin 或用 JetBrains Runtime 补齐。
