Mac Java环境配置失败主因是shell配置文件选错、环境变量错误或未生效；zsh默认读~/.zshrc而非~/.bash_profile，JAVA_HOME须用/usr/libexec/java_home动态获取，PATH应export PATH="$JAVA_HOME/bin:$PATH"并source ~/.zshrc验证。
Mac 上 Java 开发环境配不起来，大概率不是 Java 没装好，而是 shell 配置文件选错了、环境变量写错了、或者没生效。
zsh 是 macOS Catalina 及之后的默认 shell，.bash_profile 不会自动加载
macOS 10.15（Catalina）起系统默认用 zsh，不是 bash。你往 .bash_profile 里加了 JAVA_HOME 和 PATH，终端根本不会读它——除非你手动执行 source ~/.bash_profile，或者改回用 bash（不推荐）。
- 检查当前 shell：
echo $SHELL，输出是/bin/zsh就说明你在用 zsh - zsh 默认读的是
~/.zshrc，不是~/.bash_profile - 如果非要复用旧配置，可以在
~/.zshrc末尾加一行：source ~/.bash_profile，但更干净的做法是把配置统一挪到~/.zshrc
JAVA_HOME 不能手写路径，要用 /usr/libexec/java_home 动态获取
硬编码 JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home 看似能用，但换 JDK 版本、重装、或用 SDKMAN! / jEnv 切版本时立刻失效。macOS 自带的 /usr/libexec/java_home 命令才是可靠来源。
- 查当前默认 JDK 路径：
/usr/libexec/java_home - 查所有已安装 JDK：
/usr/libexec/java_home -V - 指定版本（比如 JDK 17）：
/usr/libexec/java_home -v 17 - 在
~/.zshrc中这样写：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
PATH 添加方式错误会导致 java 命令找不到或版本错乱
常见错误是直接 export PATH="/path/to/java/bin"，这会覆盖整个 PATH，导致 ls、cd 等基础命令失效。也有人写成 PATH=$PATH:/path/to/java/bin 却漏了 export，变量只在当前行生效。
立即学习“Java免费学习笔记（深入）”；
- 正确写法（追加且导出）：
export PATH="$JAVA_HOME/bin:$PATH" - 顺序很重要：把
$JAVA_HOME/bin放前面，确保java、javac优先调用你配的 JDK - 写完别忘了让配置生效：
source ~/.zshrc（不是source ~/.bash_profile） - 验证：
which java应该输出$JAVA_HOME/bin/java；java -version显示预期版本
IDE（如 IntelliJ）或终端新窗口不读 .zshrc？检查终端是否以登录 shell 启动
某些终端（比如 VS Code 内置终端、iTerm2 的非登录模式）默认不加载 ~/.zshrc，导致环境变量为空。这不是配置错，而是 shell 启动模式问题。
- iTerm2：Preferences → Profiles → General → Shell → “Login shell” 打钩
- VS Code：设置里搜
terminal.integrated.defaultProfile.osx，确认是zsh；再检查terminal.integrated.shellArgs.osx是否为空，非空可能干扰登录行为 - IntelliJ：Preferences → Tools → Terminal → “Shell path” 设为
/bin/zsh，并勾选 “Shell integration”（新版推荐）
最常被忽略的是：改完 .zshrc 后只在当前终端测试，却没新开一个终端窗口验证——而 IDE 或脚本启动的子进程，用的就是全新 shell 实例。别信“我刚 source 过”，要真开个新窗口跑 echo $JAVA_HOME 看一眼。
