根本原因是未理清“谁在用、在哪配、怎么生效”三层逻辑：需先用echo $shell确认shell类型（macos catalina后默认zsh，应配~/.zshrc并source），java_home必须指向jdk根目录而非bin子目录，推荐用/usr/libexec/java_home -v动态获取路径，配置后须source生效并分场景验证。
Mac 上 JDK 安装后环境变量出错，根本原因往往不是操作步骤错了，而是没理清“谁在用、在哪配、怎么生效”这三层逻辑。只要抓住关键点，基本不会反复踩坑。
确认当前 Shell 类型再动手
macOS Catalina（10.15）起默认用 zsh，不是 bash。如果你照着老教程往 ~/.bash_profile 里写配置，终端里 java -version 能运行，但 IDE 或新打开的终端就是不认——大概率是 Shell 配错了。
- 终端输入
echo $SHELL，输出/bin/zsh就该配~/.zshrc - 输出
/bin/bash才配~/.bash_profile - 不确定？统一配
~/.zshrc（绝大多数新机都是 zsh），然后执行source ~/.zshrc生效
JAVA_HOME 必须指向 JDK 根目录，不是 bin
常见错误：把 JAVA_HOME 设成 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin ——多写了 /bin，导致 Maven、Gradle、IDE 全部找不到 JDK。
- 正确路径示例：
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home - 快速验证命令：
/usr/libexec/java_home -v 17（自动返回系统已识别的 JDK 17 路径） - 配置写法（加到
~/.zshrc）：export JAVA_HOME=$(/usr/libexec/java_home -v 17)export PATH=$JAVA_HOME/bin:$PATH
避免多个 JDK 版本互相干扰
手动拖拽安装多个 JDK 后，java 命令可能调用的是系统自带旧版或 OpenJDK，而不是你刚装的新版。
- 先查所有已注册 JDK：
/usr/libexec/java_home -V - 只让指定版本生效，不要依赖 PATH 顺序拼运气
- 推荐做法：用
java_home -v动态获取路径，而不是硬编码绝对路径（比如/Library/.../jdk-17.jdk/...） - 如果用了 Homebrew 安装（如
brew install openjdk@17），路径在/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk，同样要用java_home命令取值
配置完必须重新加载，且验证方式要分场景
改完 ~/.zshrc 不等于立刻生效，而且不同工具读取环境变量的方式不同。
- 终端内执行：
source ~/.zshrc（别忘了这步） - 验证命令行：
java -version和javac -version必须一致且是你预期的版本 - 验证 IDE（如 IntelliJ）：需重启 IDE，或在设置里手动指定 JDK 路径（不能只信自动探测）
- 验证脚本或构建工具（如 Maven）：在终端运行
mvn -v，看输出的 Java 版本是否匹配
