运行java程序必须设置path、java_home和classpath三个环境变量，分别指向jdk的bin目录、安装根目录和类库路径，其中java_home供maven等工具定位jdk，path使javac/java命令全局可用，classpath在现代开发中通常可省略。
java 程序本身不直接读取环境变量来运行，但整个 java 开发与运行生态高度依赖几个关键环境变量——它们不参与字节码执行，却决定“谁来执行”“从哪找工具”“用哪个 jdk”。理解这点，就抓住了调试中环境相关问题的根源。
JAVA_HOME：JDK 的“户籍地址”
它不是 JVM 启动必需项，却是绝大多数外部工具的起点。Maven 执行 mvn compile 时会先查 JAVA_HOME；IDEA 启动项目前会用它定位 javac 和调试器；Tomcat 启动脚本直接依赖它加载 tools.jar（旧版）或 jdk.internal.vm.compiler（新版）。如果值为空或指向错误目录，你会看到：
- Maven 报错：
The JAVA_HOME environment variable is not defined correctly - Tomcat 启动失败，提示
Cannot find java or javac - IDE 中“Project SDK”识别为
Unknown
注意：必须填 JDK 根目录（如 C:\Program Files\Java\jdk-17.0.2），不能填 bin 子目录；路径含空格时无需引号，Windows 下用反斜杠即可。
PATH：命令行能否“喊到人”的关键
当你在终端输入 java -version 或 javac Main.java，系统并不知道该执行哪个 java.exe。它按 PATH 中列出的目录顺序查找可执行文件。若未将 %JAVA_HOME%\bin 加入 PATH，就会出现：
'java' is not recognized as an internal or external command-
javac找不到，但java却能运行（说明系统 PATH 里有 JRE 的java.exe，但没配 JDK 的javac.exe）
常见陷阱：多个 JDK 共存时，PATH 中靠前的 bin 目录会优先被选中。调试时发现 java -version 和 javac -version 输出版本不一致，大概率是 PATH 混入了不同 JDK 的 bin 路径。
CLASSPATH：现代开发中基本可忽略
它告诉 JVM 从哪些路径加载 .class 文件和 .jar 包。但在 JDK 5 之后，JVM 默认包含当前目录（.）；Maven、Gradle 通过构建配置自动管理依赖路径；IDE 自动合成运行类路径。手动配置 CLASSPATH 反而容易引发冲突，比如：
- 覆盖了 Maven 自动注入的依赖，导致
NoClassDefFoundError - 引入了旧版 jar，引发
LinkageError或方法找不到异常
除非维护极老项目（如 JDK 1.4 时代遗留系统），否则不要设置 CLASSPATH。临时需要指定路径时，用 -cp 参数更安全，例如：java -cp lib/mylib.jar:. MyApp。
调试环境变量问题的实用步骤
遇到 Java 命令异常或工具报 JDK 错误时，别急着重装，按顺序验证：
- 运行
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），确认输出是有效 JDK 路径 - 运行
where java（Windows）或which java（macOS/Linux），看返回路径是否属于%JAVA_HOME%\bin - 运行
java -version和javac -version，两个输出版本号应完全一致 - 打开 IDE 的项目结构设置，检查 “Project SDK” 是否与
JAVA_HOME指向同一 JDK
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
