macOS 10.15+ 系统不再预装 java 命令，需用 brew install openjdk@17 安装并手动配置 PATH（如 export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"），再通过 .zshrc 或 .zprofile 生效，IDE 需单独配置 java.home 路径。
确认系统自带Java是否可用
macOS 从 10.7 开始预装了 Java 运行时，但自 macOS 10.15（Catalina）起，系统不再默认包含 java 命令，且 Oracle 官方 JDK 也不再随系统分发。直接运行 java -version 很可能报错：command not found: java —— 这不是你漏装了，而是系统压根没配。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先执行
which java和/usr/libexec/java_home -V，看是否有输出；若无，说明未安装任何 JDK - 不要依赖
brew install java（Homebrew 会报错：该 formula 已弃用），正确命令是brew install openjdk或指定版本如brew install openjdk@17 - 系统自带的
/System/Library/Frameworks/JavaVM.framework是遗留接口，不可用于开发，调用会失败或触发安全警告
用 Homebrew 安装 OpenJDK 并配置 PATH
Homebrew 是最稳定、更新及时的方式，OpenJDK（如 Temurin 或 Eclipse Adoptium 构建版）已成 macOS 开发主流选择，兼容性好、无许可证风险。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 安装前确保 Homebrew 已就绪：
brew --version有输出即可；若未装，按官网脚本执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 执行
brew install openjdk@17（推荐 LTS 版本）；安装完成后注意终端输出的提示，它会明确告诉你下一步要做什么 - 必须手动将 JDK 的 bin 目录加入
PATH：在~/.zshrc（macOS Catalina 及以后默认 shell）中追加一行：export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/opt/openjdk@17/bin:$PATH"（Intel） - 重载配置：
source ~/.zshrc，再运行java -version和javac -version验证两者是否一致
多个 JDK 共存时如何切换版本
项目依赖不同 JDK 版本（比如 Spring Boot 3.x 要求 JDK 17+，而老项目还在用 JDK 8）是常态，硬改 PATH 效率低还易出错。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用
/usr/libexec/java_home -V查看所有已安装 JDK 的路径和版本号 - 临时切换当前终端的 JDK：
export JAVA_HOME=$(/usr/libexec/java_home -v 17)（支持模糊匹配，-v 17会选最新 17.x） - 为特定项目设置局部 JDK：在项目根目录下创建
.java-version文件，写入17.0.1（仅版本号），再配合jabba或SDKMAN!工具自动加载（推荐jabba，轻量、Zsh 友好） - 避免用
sudo ln -sf手动链接/usr/bin/java—— 系统保护机制可能拒绝写入，且破坏 SIP 安全性
验证 IDE（IntelliJ / VS Code）能否识别新 JDK
命令行能跑不等于 IDE 能用。IDE 启动时读取的是自己的环境变量或独立配置，常出现「终端里 java -version 正确，但 IDEA 提示 No SDK configured」。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：打开
Project Structure → Project → Project SDK，点+→Add JDK，路径选/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk（Apple Silicon）或/usr/local/opt/openjdk@17/libexec/openjdk.jdk（Intel） - VS Code + Extension Pack for Java：需确保
java.home设置正确，在settings.json中填："java.home": "/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home" - 重启 IDE，别只 reload window —— JVM 启动参数、类路径、调试器都依赖启动时的环境，不重启大概率仍用旧配置
- 如果用了
export JAVA_HOME=...但 IDE 仍不识别，检查是否在~/.zprofile里定义（GUI 应用不读.zshrc），应统一写到.zprofile
最容易被忽略的是 shell 配置文件的加载顺序和 GUI 应用的环境继承逻辑——哪怕 java -version 在终端里完全正确，IDE 也可能启动在一个干净的、没加载你 PATH 的环境中。
