macOS 安装 JDK 无需手动配置 JAVA_HOME 或 PATH，系统通过 /usr/libexec/java_home 自动管理；推荐用 Homebrew 安装 Temurin 等发行版，安装后运行 /usr/libexec/java_home -V 验证，并在 IDE 中手动指定 SDK 路径而非依赖环境变量。
macOS 上安装 JDK 不需要手动配置 JAVA_HOME 或修改 PATH —— 现代 macOS（10.15+）和主流 JDK 发行版（如 Temurin、Zulu、Oracle JDK）已通过 /usr/libexec/java_home 自动管理，硬编码路径反而容易出错。
用 brew install 安装并自动注册（推荐）
Homebrew 是最稳妥的起点，它会把 JDK 安装到标准位置，并确保 /usr/libexec/java_home 能识别：
- 先确保已安装 Homebrew：
which brew，没有就去brew.sh官网执行一键脚本 - 安装 Temurin（Eclipse 基金会维护，免费、无商业限制）：
brew install temurin17（或temurin21） - 验证是否注册成功：
/usr/libexec/java_home -V，应看到类似17.0.10 (x86_64) "Eclipse Adoptium" - "Temurin-17"的输出 - 此时
java -version和javac -version通常已可用；如未生效，重启终端或运行source ~/.zshrc
不依赖 brew 时，直接运行 .dmg 安装包的注意事项
从官网下载 Oracle JDK 或 Temurin .dmg 后双击安装，看似完成，但 macOS 不会自动更新 shell 环境变量：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 安装后 JDK 实际路径是
/Library/Java/JavaVirtualMachines/jdk-17.jdk这类，但不要手动写死该路径 -
/usr/libexec/java_home是系统级代理命令，它读取/Library/Java/JavaVirtualMachines/下所有合法 JDK 的Contents/Home，你只需用它动态获取 - 若需在 shell 中显式设置，应写成：
export JAVA_HOME=$(/usr/libexec/java_home -v 17)，而不是固定路径 - 错误示例：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home—— 升级 JDK 后立即失效
IDE（IntelliJ / VS Code）中识别不到 JDK？检查项目 SDK 设置而非系统变量
现代 Java IDE 几乎不依赖 shell 的 JAVA_HOME，而是直接调用 /usr/libexec/java_home 或允许你浏览选择：
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：File → Project Structure → Project Settings → Project → Project SDK → 点「+」→ Add JDK → 选
/Library/Java/JavaVirtualMachines/...下对应版本 - VS Code + Extension Pack for Java：打开命令面板（Cmd+Shift+P）→ “Java: Configure Java Runtime” → 在 “Java Configuration > JDK” 区域点编辑图标，选已安装的 JDK 目录
- 别在 IDE 设置里填
$JAVA_HOME，IDE 不解析 shell 变量；也不信“重启 IDE 就自动识别”的说法，必须手动指定一次
真正容易被忽略的是：macOS 的 java_home 工具只扫描 /Library/Java/JavaVirtualMachines/，不会看用户目录（如 ~/jdk）或自定义路径。哪怕你把 JDK 解压进 /opt/jdk，也得用符号链接或重装到标准位置才能被识别。这点和 Linux 完全不同。
