必须从 Eclipse Adoptium 官网下载 Temurin JDK 11 的 macOS pkg 包，按向导安装至 /Library/Java/JavaVirtualMachines/，再通过 /usr/libexec/java_home -v 11 设置 JAVA_HOME 并更新 PATH，最后验证 java -version 输出正确版本。
要在 macOS Sonoma 系统上安装 Temurin JDK 11（即 Eclipse Temurin 11，原 AdoptOpenJDK），必须避开 Oracle 官网的商业许可陷阱，直接从 Eclipse 官方可信源下载、校验并正确部署到系统标准路径，否则后续 Java 工具链（如 Maven、Gradle、IntelliJ）将无法识别或报错“no suitable JDK found”。
下载 Temurin JDK 11 for macOS Sonoma
打开浏览器，访问 https://www.php.cn/link/65904bcd52a06cd64e57fc80b4b042d0。
在版本列表中找到最新稳定版（截至 2026 年 8 月为 11.0.22+7），确认其 Build Type 为 “HotSpot”，OS 为 “macOS”，Architecture 为 “x64”（Intel 芯片）或 “aarch64”（Apple Silicon M 系列芯片）——【选错架构会导致 java 命令崩溃或 Segmentation fault】。
点击对应版本右侧的 “pkg” 下载按钮（不是 tar.gz），文件名形如 OpenJDK11U-jdk_x64_mac_hotspot_11.0.22_7.pkg 或 OpenJDK11U-jdk_aarch64_mac_hotspot_11.0.22_7.pkg，保存到默认下载目录。
安装 pkg 包并验证基础路径
双击下载好的 .pkg 文件，按向导点击「继续→安装→输入管理员密码→完成」。
安装完成后，JDK 会自动部署到 /Library/Java/JavaVirtualMachines/ 目录下，名称通常为 jdk-11.0.22+7.jdk。
打开终端，执行以下命令确认安装位置是否可见：
/usr/libexec/java_home -V
输出中应包含一行类似：11.0.22 (x86_64) "Eclipse Temurin" - /Library/Java/JavaVirtualMachines/jdk-11.0.22+7.jdk/Contents/Home
配置 JAVA_HOME 并启用 Temurin JDK 11
第一步：确认当前 shell 类型，执行 echo $SHELL；若输出 /bin/zsh（macOS Catalina 及之后默认），则编辑 ~/.zshrc；若为 /bin/bash，则编辑 ~/.bash_profile。
第二步：用文本编辑器打开配置文件，例如：nano ~/.zshrc
第三步：在文件末尾添加以下两行（注意替换为你实际看到的版本号，不要照抄 11.0.22+7）：
export JAVA_HOME=$(/usr/libexec/java_home -v 11)export PATH=$JAVA_HOME/bin:$PATH
第四步：使配置生效：source ~/.zshrc
第五步：验证是否生效：java -version
输出应为：openjdk version "11.0.22" 2026-07-16OpenJDK Runtime Environment Temurin-11.0.22+7 (build 11.0.22+7)OpenJDK 64-Bit Server VM Temurin-11.0.22+7 (build 11.0.22+7, mixed mode)
