Java在macOS配置的核心是正确设置JAVA_HOME并确保GUI工具继承终端环境：先用/usr/libexec/java_home -V确认JDK路径，再在~/.zshrc中导出JAVA_HOME和PATH，最后通过终端启动IDE或重装code命令使配置生效。
Java 在 macOS 上的环境配置，核心是让 java、javac 命令能被终端识别，且指向你期望的 JDK 版本。系统自带的 Java（如旧版 JRE）或通过不同方式安装的 JDK（Homebrew、SDKMAN、官网下载）会共存，不手动干预极易出现“明明装了 JDK 17，java -version 却显示 1.8”的问题。
确认已安装的 JDK 路径（不是靠 which java）
macOS 的 which java 只返回 shell 查找路径中的第一个可执行文件，常是 /usr/bin/java —— 这只是系统 stub，实际由 /usr/libexec/java_home 管理。真正有效的做法是：
- 运行
/usr/libexec/java_home -V，列出所有已注册的 JDK，输出类似：
$ /usr/libexec/java_home -V
Matching Java Virtual Machines (3):
17.0.2 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 17" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
11.0.20 (x86_64) "Amazon Corretto" - "Amazon Corretto 11" /Library/Java/JavaVirtualMachines/corretto-11.jdk/Contents/Home
1.8.0_382 (x86_64) "Oracle Corporation" - "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_382.jdk/Contents/Home- 注意每行末尾的完整路径，这才是你要用的
JAVA_HOME值 - 不要复制
/usr/bin/java或~/.sdkman/candidates/java/current这类符号链接路径，它们不稳定
设置 JAVA_HOME 并注入 PATH（推荐用 zsh 配置）
macOS Catalina 及之后默认 shell 是 zsh，配置文件是 ~/.zshrc（不是 ~/.bash_profile）。直接写死路径最可靠：
- 编辑
~/.zshrc：nano ~/.zshrc - 添加两行（以 Temurin 17 为例，路径必须与
java_home -V输出一致）：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
- 保存后执行
source ~/.zshrc生效 - 验证：
echo $JAVA_HOME应输出完整路径；java -version和javac -version应一致且匹配预期版本 - 如果用了 SDKMAN，它会覆盖
JAVA_HOME，此时需确保sdk default java 17.0.2-tem已执行，并在~/.zshrc中把source "$HOME/.sdkman/bin/sdkman-init.sh"放在JAVA_HOME设置之后
IntelliJ / VS Code 不读取 shell 配置？启动方式很重要
GUI 应用（如 IntelliJ、VS Code）默认不加载 ~/.zshrc，因此即使终端里 java -version 正确，IDE 仍可能报 “Cannot resolve JDK” 或沿用旧版本。
立即学习“Java免费学习笔记（深入）”；
- VS Code：在命令面板（
Cmd+Shift+P）中运行Shell Command: Install 'code' command in PATH，然后**完全退出并重启 VS Code** - IntelliJ：不要双击 App 启动，改用终端命令启动：
open -a "IntelliJ IDEA.app"或/Applications/IntelliJ IDEA.app/Contents/MacOS/idea—— 这样它会继承 shell 环境变量 - 若仍无效，在 IntelliJ 的
Help > Edit Custom Properties...中添加：idea.jdk.home.path=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
真正的难点不在“怎么装”，而在于 macOS 对 Java 的多层抽象（stub → java_home → 实际 JDK），以及 GUI 与终端环境隔离带来的隐性不一致。每次换 JDK 后，务必重新运行 /usr/libexec/java_home -V 确认路径，再同步更新 JAVA_HOME 和 IDE 启动方式。
