JAVA_HOME必须指向JDK根目录(如C:\Program Files\Java\jdk-17.0.1),不可指向JRE或bin子目录;PATH中%JAVA_HOME%\bin须优先于System32;CLASSPATH一般应删除;多JDK切换只改JAVA_HOME并重启终端。

JAVA_HOME 必须指向 JDK 根目录,不能是 jre 或 bin
很多问题源于 JAVA_HOME 指向了 C:\Program Files\Java\jre1.8.0_301 或 ...\jdk-17.0.1\bin —— 这两种都错。JDK 启动工具(如 javac、java)依赖 JAVA_HOME 下的 lib、bin、jre 等子目录结构,路径错位会导致 javac 找不到 tools.jar(JDK 9+ 虽已移除,但启动逻辑仍校验目录层级)。
正确写法示例:JAVA_HOME = C:\Program Files\Java\jdk-17.0.1
验证方式:运行 %JAVA_HOME%\bin\java -version 和 %JAVA_HOME%\bin\javac -version 都应成功输出版本号。
PATH 中 %JAVA_HOME%\bin 必须排在系统自带 java 前面
Windows 默认可能在 System32 下放了个旧版 java.exe(来自旧 JRE 或 Oracle 安装包残留),如果 PATH 里 C:\Windows\System32 在 %JAVA_HOME%\bin 之前,命令行执行 java 实际调用的是那个“幽灵 java”,和 JAVA_HOME 完全无关。
检查顺序的方法:
- 运行 where java(Windows)或 which java(Linux/macOS)
- 查看输出的第一行是否为 %JAVA_HOME%\bin\java.exe
常见错误配置:PATH = C:\Windows\System32;%JAVA_HOME%\bin;... → 错PATH = %JAVA_HOME%\bin;C:\Windows\System32;... → 对
CLASSPATH 一般不需要手动设置,设了反而容易出问题
除非你明确在用老式 java -cp 以外的方式加载类(比如某些 IDE 插件或 Ant 构建脚本),否则现代 JDK(8+)完全不依赖环境变量 CLASSPATH。JVM 启动时默认只查当前目录(.)和 -jar 指定的 jar,不会自动拼接 CLASSPATH。
立即学习“Java免费学习笔记(深入)”;
如果你设置了它,又漏写了 .,就会出现“找不到主类”或“NoClassDefFoundError”——因为 JVM 不再默认包含当前目录。
建议:
- 彻底删除 CLASSPATH 环境变量
- 如需指定类路径,一律用 java -cp "lib/*;." MyApp 显式传参
- Maven/Gradle 项目中,该变量完全无意义
多个 JDK 共存时,切换靠改 JAVA_HOME + 重启终端,不是改 PATH
有人试图通过在 PATH 里硬编码不同 JDK 的 bin 路径来“切换”,这是反模式。PATH 是扁平字符串,没有“作用域”概念;而 JAVA_HOME 是所有 Java 工具链(Maven、Gradle、IDEA、Spring Boot DevTools)识别 JDK 版本的唯一事实来源。
正确做法:
- 安装多个 JDK(如 jdk-8u291、jdk-17.0.1)到不同目录
- 统一用 JAVA_HOME 指向当前要使用的那个根目录
- 每次修改后,**必须新开命令行窗口**(CMD/PowerShell/terminal)——已打开的终端不会重读环境变量
- IDE(如 IntelliJ)也需要重启,或在设置中手动指定 Project SDK,不能只信系统变量
容易被忽略的一点:Windows 的“系统属性 → 环境变量”界面里,JAVA_HOME 如果在“用户变量”和“系统变量”中同时存在,优先级取决于你以什么身份运行终端(普通用户 vs 管理员),这会引发不可预测行为。统一只在“系统变量”中定义更稳妥。










