在 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 删不干净？
  如果之前乱删导致安装失败，可以参考 macOS 完全卸载 Java 教程 先进行彻底清理。