Java开发需正确配置JDK环境变量，确保JAVA_HOME与PATH指向同一JDK根目录且包含bin，验证须同时检查java -version、javac -version及JAVA_HOME路径一致性，IDE和构建工具配置独立于系统变量。
Java开发必须先装JDK，但直接下载安装包双击运行，常导致java -version能用、javac报“不是内部或外部命令”，或IDE识别不到SDK——根本原因是环境变量没配对，或版本混用。
确认系统架构和JDK版本匹配
Windows 11/10 64位系统别装32位JDK；macOS Apple Silicon（M1/M2/M3）必须选aarch64版本，x86_64版会通过Rosetta转译，javac编译慢且部分工具（如某些JNI库）直接失败。Linux用户注意区分tar.gz（免安装）和.rpm/.deb（带系统集成）包——后者会自动注册替代方案（update-alternatives），前者全靠手动配置。
PATH和JAVA_HOME必须同时设置且指向同一目录
只配PATH不配JAVA_HOME，IntelliJ IDEA、Maven、Gradle可能找不到JDK根路径；只配JAVA_HOME不加bin到PATH，终端里javac就执行不了。关键点：
-
JAVA_HOME值必须是JDK安装根目录（如C:\Program Files\Java\jdk-21），不能带\bin -
PATH里要追加%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux） - 修改后重启终端或命令行窗口，
echo $JAVA_HOME和which javac要能输出一致路径
验证时别只信java -version
这个命令只检查JRE运行时，掩盖了javac缺失或版本错配的问题。必须逐条执行：
立即学习“Java免费学习笔记（深入）”；
-
java -version→ 看是否输出JDK版本号（含“Java SE Runtime Environment”字样不算，得有“Java SE Development Kit”） -
javac -version→ 必须返回和java一致的版本，否则说明PATH指向了JRE而非JDK -
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）→ 输出路径末尾不能是\bin，且该路径下必须存在lib\tools.jar（旧版）或lib\jrt-fs.jar（JDK 9+）
IDE中JDK配置与系统环境变量无关
IntelliJ IDEA、Eclipse、VS Code的Java插件都绕过系统JAVA_HOME，各自维护SDK列表。常见陷阱：
- 新建项目时默认选的是IDE内置的“bundled JDK”，不是你刚装的JDK
- 项目级SDK设置（Project SDK）和模块级语言级别（Language Level）要匹配，比如选了JDK 21，却把Language Level设成8，会导致
var关键字报错 - Gradle项目还要检查
gradle.properties里的org.gradle.java.home，它优先级高于IDE设置
最易被忽略的是多版本共存时的隐式覆盖：卸载旧JDK后，注册表（Windows）或/usr/libexec/java_home（macOS）缓存未清理，新装的JDK可能被跳过。动手前先查where java（Windows）或which java（macOS/Linux），再看java -XshowSettings:properties -version 2>&1 | grep java.home——这两个路径不一致，八成就是环境变量和实际执行链脱节了。
