在 macOS 上配置 Java 环境时，很多开发者会遇到 no bottle available 或环境变量配置失效的问题。本文将介绍目前最稳定、最推荐的安装方式：使用 Homebrew Cask 安装 Eclipse Temurin。
为什么选择 Temurin？
- 兼容性好：前身为 AdoptOpenJDK，是目前最主流的 OpenJDK 发行版。
- 安装简单：使用 Cask 安装会自动放入系统目录，无需手动配置繁琐的
PATH。 - 识别率高：IntelliJ IDEA、Eclipse 等 IDE 可以直接识别，无需寻找隐藏路径。
🚀 安装步骤
1. 确保 Homebrew 已更新
在安装任何新软件包之前，建议先更新 Homebrew 索引：
brew update
2. 执行安装命令
直接在终端输入以下正确命令：
brew install --cask temurin@21
*注：使用 --cask 会直接下载预编译好的 .pkg 安装包，避开复杂的源码编译过程。
3. 验证安装
安装完成后，无需重启电脑，只需新开一个终端窗口或执行 source，然后输入：
java -version
预期输出：
openjdk version "21.x.x" … Runtime Environment Temurin-21…
🛠 进阶技巧：多版本管理
如果你电脑上同时需要 Java 8, 11 和 21，可以按照以下逻辑操作：
1. 安装其他版本
brew install --cask temurin@8
brew install --cask temurin@17
2. 快速切换版本
macOS 提供了一个强大的工具 /usr/libexec/java_home 来定位不同版本。你可以通过在 ~/.zshrc 中添加别名来快速切换：
# 编辑配置文件
nano ~/.zshrc
# 添加以下内容（按需开启）
export JAVA_21_HOME=$(/usr/libexec/java_home -v 21)
export JAVA_8_HOME=$(/usr/libexec/java_home -v 1.8)
# 默认使用 Java 21
export JAVA_HOME=$JAVA_21_HOME
# 保存退出后运行
source ~/.zshrc
❓ 常见问题排查
- 提示 'Permission Denied'？
安装 Cask 软件通常需要系统管理员权限，请在提示时输入你的 Mac 开机密码。 - IDE 找不到 JDK？
Temurin 默认安装在/Library/Java/JavaVirtualMachines/。在 IntelliJ IDEA 中，点击Project Structure->SDKs->+号，直接指向该目录即可。 - 之前手动删过 Java 删不干净？
如果之前乱删导致安装失败，建议先进行彻底清理后再重试。