环境搭建是首次接触Java运行机制的实操门槛，需正确配置JAVA_HOME指向JDK根目录、PATH包含其bin路径，并确保javac与java版本一致，否则将导致编译或运行失败。
环境搭建不是“第一步”，而是你第一次真正面对 Java 运行机制的实操门槛——没配好 javac 和 java，连最简单的 System.out.println("Hello") 都会报 Error: Could not find or load main class 或 command not found。
为什么 JAVA_HOME 必须指向 JDK 而不是 JRE
JDK 包含编译器 javac、调试器 jdb、打包工具 jar 等；JRE 只有运行时环境。IDE（如 IntelliJ）或构建工具（如 Maven）在调用 javac 时，会优先读取 JAVA_HOME。若指向 JRE，mvn compile 直接失败，报错 The JAVA_HOME environment variable is not defined correctly。
-
JAVA_HOME应设为 JDK 安装根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-21） - Windows 下检查：
echo %JAVA_HOME%；macOS/Linux 下：echo $JAVA_HOME -
PATH中应包含%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux），否则终端找不到javac
javac 编译成功但 java 执行失败的常见原因
这是初学者最常卡住的环节：明明写了 Hello.java，javac Hello.java 没报错，可 java Hello 却提示 Could not find or load main class Hello。
- 当前目录下没有生成
Hello.class文件（检查是否误删、是否在错误目录执行了javac） - 类名与文件名不一致（
public class Hello必须保存为Hello.java，大小写敏感） - 执行
java时加了.class后缀（错：java Hello.class；对：java Hello） - 当前目录不在
CLASSPATH中（默认.在 classpath，但若手动设置了CLASSPATH环境变量且没包含.，就会找不到）
IDE 自带 JDK 和系统 JDK 不一致导致的诡异问题
IntelliJ 默认使用 Bundled JDK（如 JetBrains Runtime），而终端命令行用的是系统配置的 JAVA_HOME。这会导致：在 IDE 里能跑的代码，终端里 java -version 显示 JDK 17，但 javac -version 显示 JDK 21，编译出的字节码版本不兼容。
立即学习“Java免费学习笔记（深入）”；
- 检查一致性：终端运行
java -version和javac -version，二者主版本号必须相同（如都是 17 或都是 21） - IntelliJ 中需同步：File → Project Structure → Project → Project SDK → 选和终端一致的 JDK
- Maven 项目还需确认
pom.xml中maven-compiler-plugin的source和target与 JDK 版本匹配（JDK 21 对应21，不是1.21）
环境问题从来不是“配完就完”的一步，而是贯穿整个学习过程的隐性依赖。每次换机器、升级 JDK、切项目分支，都可能触发新的路径或版本冲突。最稳妥的做法是：每次新开终端，先跑一遍 javac -version && java -version && echo $JAVA_HOME —— 看三者是否自洽，比反复猜错因高效得多。
