报错源于环境变量配置失效或PATH未正确注入，需依次验证JDK是否真实安装、JAVA_HOME是否指向含bin的JDK根目录、PATH是否以$JAVA_HOME/bin开头，并通过source或新开终端使配置生效。
在macOS或Linux系统中执行java -version时提示command not found，或javac可用但java不可用，这类报错几乎都源于环境变量配置失效、路径未正确注入PATH，或shell会话未加载新配置。
确认JDK是否真实安装到位
先别急着改配置文件，直接验证JDK有没有真正落盘。打开终端，执行：
ls /Library/Java/JavaVirtualMachines/（macOS）或 ls /usr/lib/jvm/ /opt/java/（Linux）
如果返回空或“No such file or directory”，说明JDK压根没装好——此时重装比修环境变量更高效。Homebrew用户可运行brew install openjdk@17；手动解压用户请检查tar -xzf后是否进入目标目录执行了sudo mv操作。
检查JAVA_HOME是否指向真实bin目录
很多教程只教设JAVA_HOME，却漏掉最关键的一环：这个路径下必须存在bin子目录，且bin里要有java、javac等可执行文件。
运行 echo $JAVA_HOME 查看当前值，再立刻执行 ls $JAVA_HOME/bin | grep java。若无输出，说明JAVA_HOME路径错误或指向了JRE而非JDK目录。
【常见错误】 把/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/jre设为JAVA_HOME——这是JRE路径，里面没有javac，只有java。
PATH中是否真正包含$JAVA_HOME/bin
执行 echo $PATH，观察输出中是否有形如 /Library/Java/JavaVirtualMachines/.../Home/bin 的完整路径。注意：不能只看到/home或/usr/lib/jvm，必须精确到bin层级。
若缺失，说明你只设置了JAVA_HOME，但没把它追加进PATH。这时要回溯到shell配置文件（~/.zshrc、~/.bash_profile或/etc/profile），检查是否存在 export PATH=$JAVA_HOME/bin:$PATH 这类语句。
特别注意：Linux某些发行版默认PATH已含/usr/bin，而系统自带openjdk可能就装在那里。如果你把$JAVA_HOME/bin放在PATH末尾，系统会优先调用旧版本——【关键动作】 把$JAVA_HOME/bin放在PATH最前面，写成 export PATH=$JAVA_HOME/bin:$PATH。
配置文件修改后为何不生效？
方法一：立即生效（推荐）
在当前终端运行 source ~/.zshrc（macOS Sonoma及更新版默认zsh）或 source ~/.bashrc（Linux常用）。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
方法二：新开终端窗口
关闭所有终端标签页，重新打开一个——旧会话里的环境变量不会自动刷新。
方法三：强制重载shell
输入 exec zsh 或 exec bash，让当前会话丢弃旧环境、启动新shell进程。
⚠️ 提示：不要用 sudo source，这会在root权限下加载配置，但你的普通用户会话依然无效。
多JDK共存时版本混乱的快速切换
第一步：确认各JDK安装路径
macOS运行 /usr/libexec/java_home -V，Linux运行 update-java-alternatives -l，列出所有已注册JDK及其路径。
第二步：临时切换（仅当前终端有效）
export JAVA_HOME=$(/usr/libexec/java_home -v 17) → macOS专用命令，自动定位JDK 17根目录；Linux用户可写 export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64。
第三步：永久绑定别名
在~/.zshrc末尾添加 alias jdk17='export JAVA_HOME=$(/usr/libexec/java_home -v 17); export PATH=$JAVA_HOME/bin:$PATH'，保存后 source ~/.zshrc，之后只需输入 jdk17 即可切换。
