Java环境变量配置指南：Windows与macOS详解

Java环境变量配置失败主因是JAVA_HOME指向JRE、路径含空格或系统/用户级变量混用；Windows需设JAVA_HOME为JDK根目录并追加%JAVA_HOME%\bin到PATH；macOS须用/usr/libexec/java_home动态获取路径并在~/.zshrc中export；javac缺失说明安装的是JRE而非JDK。

Java 环境变量配不成功，90% 是因为 JAVA_HOME 指向了 JRE 目录、路径含空格、或系统级和用户级变量混用导致优先级错乱。直接看下面分场景操作。

Windows 上配置 JAVA_HOME 和 PATH 的实操要点

别在「系统属性 → 高级 → 环境变量」里随便新建变量名，必须严格用 JAVA_HOME（全大写、无下划线变体）；值必须是 JDK 根目录，不是 bin 子目录，更不能是 JRE 路径。

• 正确示例：C:\Program Files\Java\jdk-17.0.2（注意：若路径含空格，JAVA_HOME 本身可带空格，但后续 %JAVA_HOME%\bin 在 PATH 中仍能正常解析）
• 错误常见于复制粘贴时多出换行或中文全角字符，建议右键「编辑」后全选 → 删除 → 手动输入
• PATH 中追加：%JAVA_HOME%\bin（Windows 用百分号，不是美元符），不要重复添加多个 JDK 的 bin
• 改完后必须新开命令提示符（cmd）或 PowerShell，旧窗口不会自动刷新环境变量

macOS（Intel / Apple Silicon）配置 JAVA_HOME 的关键区别

macOS 不认 JAVA_HOME 自动生效，必须手动导出；且 Apple Silicon（M1/M2/M3）默认 JDK 路径和 Intel 不同，/usr/libexec/java_home 是唯一可靠方式。

• 先查可用 JDK：/usr/libexec/java_home -V（注意大小写，-V 不是 -v）
• 在 ~/.zshrc（macOS Catalina 及以后默认 shell）末尾加一行：export JAVA_HOME=$(/usr/libexec/java_home -v 17)（把 17 换成你要的版本号）
• 别写死路径如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home——不同安装方式路径可能不同，且升级后失效
• 执行 source ~/.zshrc 生效，验证用 echo $JAVA_HOME 和 java -version

为什么 java -version 正常但 javac 找不到？

根本原因：你装的是 JRE（Java Runtime Environment），不是 JDK（Java Development Kit）。JRE 只含 java 命令，不含 javac、javadoc 等开发工具。

• Windows 下检查 %JAVA_HOME%\bin 目录是否存在 javac.exe
• macOS 下检查 $JAVA_HOME/bin/javac 是否存在（用 ls $JAVA_HOME/bin/javac）
• 下载地址只认官网：https://adoptium.net/ 或 https://www.oracle.com/java/technologies/downloads/ —— 别用第三方打包的“精简版”
• Android Studio 自带的 JDK 默认不加入系统 PATH，不能直接拿来用

最容易被忽略的是：Windows 用户习惯双击安装 JDK，却没注意安装向导最后一页是否勾选了「Add to PATH」——这个选项只影响当前用户的 PATH，且不设置 JAVA_HOME；macOS 用户容易把 export JAVA_HOME=... 写进 ~/.bash_profile 却忘了 zsh 已是默认 shell。