JDK 17 在 macOS Big Sur 安装后 java -version 报错或显示旧版本，根本原因是 shell 配置文件未正确编辑、未重载或路径错误；须先用 /usr/libexec/java_home -V 验证安装，再根据 echo $SHELL 确认 shell 类型，严格在 ~/.zshrc 或 ~/.bash_profile 中添加 JAVA_HOME=$(/usr/libexec/java_home -v 17) 和 export PATH=$JAVA_HOME/bin:$PATH，最后执行 source 生效并用 echo $JAVA_HOME、which java、java -version 三步验证。
在 macOS Big Sur 系统上装完 JDK 17 后，终端里敲 java -version 却报“command not found”，或者显示旧版本，说明环境变量根本没被系统读取——这不是安装失败，而是 shell 配置文件没写对、没重载、或路径指向了错误位置。
确认 JDK 17 已真实安装
先别急着改配置文件，用系统命令验证 JDK 是否真装进来了：/usr/libexec/java_home -V
这条命令会列出所有已注册的 Java 版本。如果输出里没有带 “17.” 字样的条目，说明安装压根没成功，后续所有配置都是白忙。
若没看到 JDK 17，回退检查：Homebrew 安装是否执行了 brew install openjdk@17；手动安装是否双击运行了 .pkg 并输入了管理员密码；安装后是否在 /Library/Java/JavaVirtualMachines/ 目录下能看到类似 jdk-17.jdk 的文件夹。
精准定位当前 shell 类型并编辑对应配置文件
Big Sur 默认使用 zsh，但部分用户可能切换过 shell，或通过终端应用（如 iTerm2）设置了不同启动方式。执行：echo $SHELL
结果是 /bin/zsh 就编辑 ~/.zshrc；如果是 /bin/bash，则必须改 ~/.bash_profile ——改错文件，写一百遍也没用。
打开对应文件：nano ~/.zshrc
注意：不要用 TextEdit 或 Pages 打开，它们会插入不可见格式字符，导致 source 失败。
在文件末尾添加这两行（严格按顺序，不能颠倒）：
JAVA_HOME=$(/usr/libexec/java_home -v 17)<br>export PATH=$JAVA_HOME/bin:$PATH
【关键】JAVA_HOME 必须用 /usr/libexec/java_home -v 17 动态获取，绝不能硬写成 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home ——后者在系统更新或 Homebrew 重装后极易失效，且无法兼容 Apple Silicon 与 Intel 双架构路径差异。
让新配置立即生效
保存 nano 文件后（Ctrl+O → Enter → Ctrl+X），执行：source ~/.zshrc
这一步不是可选操作，它强制当前终端会话重新加载配置。不执行，你改的任何内容都不会起作用。
验证是否生效：
第一步：echo $JAVA_HOME —— 输出应为类似 /opt/homebrew/Cellar/openjdk@17/17.0.2/libexec/openjdk.jdk/Contents/Home（Homebrew 安装）或 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home（官方 pkg 安装）；
第二步：which java —— 输出路径必须以 $JAVA_HOME/bin 开头；
第三步：java -version 和 javac -version —— 两者输出的版本号都必须是 17.x.x。
如果 which java 返回的是 /usr/bin/java，说明 PATH 没生效，大概率是 $JAVA_HOME/bin 没放在 PATH 最前面，或者你漏掉了 export PATH=... 中的 export 关键字。
