终端显示的java -version版本不一定是实际运行版本，关键取决于JAVA_HOME和PATH顺序；需用java -XshowSettings:properties -version验证JVM实际加载版本，并在IDE中手动指定SDK。
检查当前 Java 版本是否生效
终端里执行 java -version 看到的版本，不一定就是你代码运行时实际用的版本。尤其在 macOS 或 Linux 上装了多个 JDK（比如系统自带、Homebrew、SDKMAN!、手动解压），java 命令可能指向一个旧版本，而 javac 或 IDE 却用了另一个。
真正关键的是：Java 进程启动时读取的 JAVA_HOME 和 PATH 顺序。常见错误现象包括：
- 终端显示
java -version是 17，但 IntelliJ 启动报错说“Unsupported class file major version 61”（那是 JDK 17 编译的字节码，却用 JDK 11 运行） -
which java返回/usr/bin/java，但这个只是符号链接，真实路径得用ls -l $(which java)查
实操建议：
- 先运行
echo $JAVA_HOME，确认它是否指向你期望的 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home） - 再运行
echo $PATH | tr ':' '\n' | grep java，看bin目录是否排在靠前位置；如果/usr/bin在前面，而它又软链到老版本，就会覆盖你设的JAVA_HOME - 验证生效：启动一个最简 Java 进程，用
java -XshowSettings:properties -version 2>&1 | grep java.version，它读的是 JVM 实际加载的系统属性，比单纯java -version更可靠
区分 JAVA_HOME 和 PATH 的作用
JAVA_HOME 本身不会让 java 命令生效，它只是很多工具（Maven、Gradle、Tomcat、IDE）用来定位 JDK 的约定路径；真正决定命令调用哪个 java 可执行文件的，是 PATH 中各目录的先后顺序。
容易踩的坑：
- 只设置了
JAVA_HOME，但没把$JAVA_HOME/bin加进PATH，结果java命令根本找不到或调用系统默认版本 - 在 shell 配置文件（如
~/.zshrc）里写成了export JAVA_HOME=/path/to/jdk; export PATH=$JAVA_HOME/bin:$PATH，但分号后没换行或空格导致语法错误，整个配置失效 - macOS 上通过
/usr/libexec/java_home -V查到多个 JDK，但java仍走系统默认——因为该命令输出只是参考，不自动设置环境变量
实操建议：
- 用
/usr/libexec/java_home -v 17获取 JDK 17 路径，然后显式导出：export JAVA_HOME=$(/usr/libexec/java_home -v 17) export PATH=$JAVA_HOME/bin:$PATH
- 在 IDE（如 IntelliJ）中，不要依赖系统环境变量：进入 File → Project Structure → Project → Project SDK，手动指定 JDK 路径，避免被终端环境干扰
验证 Java 编译与运行时版本是否一致
写个 Main.java 打印运行时信息，比反复敲命令更直观：
public class Main {
public static void main(String[] args) {
System.out.println("java.version = " + System.getProperty("java.version"));
System.out.println("java.home = " + System.getProperty("java.home"));
System.out.println("java.class.path = " + System.getProperty("java.class.path"));
}
}
编译和运行必须用同一套 JDK 工具链，否则会出兼容问题。例如：
- 用 JDK 21 的
javac编译，但用 JDK 11 的java运行 → 报Unsupported major.minor version - 用 Maven 构建时指定了
source和target，但没配toolchain，结果编译器版本和运行时版本不匹配
实操建议：
- 编译后用
file Main.class（macOS/Linux）或javap -verbose Main | head -5查看major version：55=JDK 11，61=JDK 17，65=JDK 21 - Maven 项目加
maven-compiler-plugin显式锁定版本：<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target></configuration></plugin>
Windows 下 JAVA_HOME 路径含空格的处理
Windows 用户常遇到的问题：JDK 装在 C:\Program Files\Java\jdk-17.0.2，但 JAVA_HOME 设成这个路径后，Maven 或脚本执行失败，报错类似 The system cannot find the path specified。
原因不是空格本身，而是很多批处理脚本（如 maven.bat）用 %JAVA_HOME% 时不加引号，导致 Program Files 被截断为两个参数。
实操建议：
- 在系统环境变量中设置
JAVA_HOME为不含空格的路径，例如软链接到C:\jdk17（用管理员权限 cmd 执行：mklink /D C:\jdk17 "C:\Program Files\Java\jdk-17.0.2"） - 或者，在批处理中显式加引号：
"%JAVA_HOME%\bin\java.exe"，但你无法控制所有第三方脚本是否这么做 - 优先使用 Windows Terminal + WSL2，避开 CMD 的路径解析缺陷；或者改用 SDKMAN! for Windows（通过 WSL 安装）
环境变量这层看似简单，但 JDK 多版本共存时，PATH 顺序、JAVA_HOME 是否被子进程继承、IDE 是否重载 shell 配置——每个环节都可能悄悄绕过你的设置。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
