brew tap 是启用第三方仓库的命令，因 homebrew 官方不维护 java 多版本包，需通过 brew tap adoptium/tap 等引入 temurin 等 jdk 发行版，再用 brew install --cask temurin21-jdk 安装指定版本。
brew tap 是什么，为什么不能直接 brew install java
Homebrew 官方仓库（core）不提供 java 公共包，因为 Java 不是单一版本、单一实现的工具——它有 OpenJDK、Oracle JDK、多个 LTS 和非 LTS 版本，还有不同厂商（Eclipse Temurin、Azul Zulu、Amazon Corretto）的构建。所以 Homebrew 把它们收拢到第三方 tap 里统一管理。brew tap 就是用来启用这些第三方仓库的命令，不是安装 Java 的替代操作，而是前置必要步骤。
常见错误现象：brew install java 报错 Error: No available formula with the name "java"，或装出来的是 openjdk 但版本太旧、没带 javac、java -version 显示不匹配。
- 必须先运行
brew tap homebrew/cask-versions（用于老版本如 Java 8/11）和brew tap homebrew/cask-adoptopenjdk（已弃用，别用） - 当前推荐的是
brew tap homebrew/cask-versions+brew tap adoptium/tap（Temurin 官方维护，LTS 支持最稳） - 执行
brew tap可查看已启用的 tap 列表，确认adoptium/tap在其中
怎么装指定 Java 版本（比如 JDK 17 或 JDK 21 LTS）
Adoptium 提供了按版本号命名的 cask，例如 temurin17-jdk、temurin21-jdk，不是靠 brew install openjdk@17 这类公式（formula）——那是编译型安装，不带完整 JRE、常缺 jshell 或 jpackage，且默认不配置 JAVA_HOME。
使用场景：需要长期支持版（LTS）、明确要求 JDK 21 的新特性（比如 virtual threads）、或 CI 环境中复现本地 Java 行为。
立即学习“Java免费学习笔记（深入）”；
- 装 JDK 21：
brew install --cask temurin21-jdk - 装 JDK 17：
brew install --cask temurin17-jdk - 装 JDK 8（仅限 legacy 项目）：
brew install --cask temurin8-jdk（注意：需提前brew tap homebrew/cask-versions） - 装完后，Java 二进制路径在
/opt/homebrew/opt/temurin21-jdk/libexec/openjdk.jdk（Apple Silicon）或/usr/local/opt/temurin21-jdk/libexec/openjdk.jdk（Intel）
JAVA_HOME 怎么设才不翻车
Mac 上 Java 启动器（比如 IntelliJ、Gradle、Maven）严重依赖 JAVA_HOME 环境变量。Homebrew 装的 Temurin 不会自动写入 shell 配置，手动设错路径是最高频的“明明装了却用不了”原因。
容易踩的坑：export JAVA_HOME=$(/usr/libexec/java_home) 会指向系统自带或最早装的 JDK，不是你刚装的 Temurin；/usr/libexec/java_home -V 可列出所有已注册 JDK，但 Homebrew 安装的 Temurin 默认**不会自动注册进系统 Java list**，除非你运行一次 sudo ln -sfn /opt/homebrew/opt/temurin21-jdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/temurin-21.jdk（可选，但推荐）
- 安全做法：在
~/.zshrc里写死路径，例如：export JAVA_HOME=/opt/homebrew/opt/temurin21-jdk/libexec/openjdk.jdk/Contents/Home - 验证是否生效：
echo $JAVA_HOME和java -version必须一致 - 如果同时装了多个版本，别用
$(/usr/libexec/java_home -v 21)——它可能找不到 Temurin，除非你先软链注册
换版本时为什么 brew uninstall 不够，还得清理残留
Homebrew 卸载 cask 只删二进制和元数据，但 JAVA_HOME、shell 配置、IDE 缓存、甚至 /Library/Java/JavaVirtualMachines/ 下的软链接都还在。下次 java -version 还可能报旧版本，或者 Gradle 报 Unsupported class file major version。
性能影响不大，但兼容性风险高：比如用 JDK 21 编译的 class 文件，被 IDE 误用 JDK 17 运行时加载，直接 java.lang.UnsupportedClassVersionError。
- 卸载前先确认当前用的版本：
java -version和echo $JAVA_HOME - 卸载命令：
brew uninstall --cask temurin17-jdk - 手动删掉旧软链（如有）：
sudo rm -f /Library/Java/JavaVirtualMachines/temurin-17.jdk - 检查并更新
~/.zshrc中的JAVA_HOME行，重载：source ~/.zshrc - IntelliJ 用户还要去
Preferences > Project > Project SDK里手动切换，它不会自动感知 Homebrew 更换
最麻烦的点其实不在安装，而在环境变量和 IDE 的双重绑定——改完终端生效，不代表 IDE 也用了新 JDK。这点很容易被忽略，直到跑测试突然失败才回头查。
