确认JDK多版本共存需验证java -version与which java是否一致，排查PATH残留旧路径；macOS用/usr/libexec/java_home -V查看并切换，Linux用update-alternatives注册全工具链，IDE和构建工具须单独配置对应JDK。
确认系统是否已安装多个JDK版本
很多开发者以为装了几个 jdk-11、jdk-17、jdk-21 就算共存成功，其实只是“物理存在”，没被系统识别或切换使用。关键看 java -version 和 which java 输出是否与预期一致。常见错误是：PATH 里残留旧 JDK 的 bin 路径，导致无论怎么改 JAVA_HOME 都不生效。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 运行
ls /Library/Java/JavaVirtualMachines/（macOS）或dir "C:\Program Files\Java\"（Windows）确认实际安装路径 - 逐个执行
/path/to/jdk-17/bin/java -version验证各版本能否独立运行 - 用
/usr/libexec/java_home -V（macOS）或update-alternatives --list java（Ubuntu）查看系统级 JDK 注册列表
macOS 下用 java_home 切换默认 JDK
macOS 自带的 /usr/libexec/java_home 是最轻量、最可靠的切换方式，它不依赖 shell 配置文件重载，也不修改全局 PATH，只动态生成路径。很多人手动改 ~/.zshrc 中的 JAVA_HOME，却忘了同步更新 PATH 里的 $JAVA_HOME/bin，结果 java 命令仍调用旧版本。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 查可用版本：
/usr/libexec/java_home -V，注意输出中每行开头的版本号和路径 - 临时切换（当前终端有效）：
export JAVA_HOME=$(/usr/libexec/java_home -v 17) - 永久切换（推荐按项目设置）：在项目根目录下加
.env文件，用direnv加载；或在 IDE 运行配置中单独指定JAVA_HOME - 避免写死路径，比如不要用
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，它易过期且不可移植
Linux（Ubuntu/Debian）用 update-alternatives 管理多 JDK
Linux 发行版通常不自带 java_home，但 update-alternatives 是标准方案。问题在于：很多人只执行 sudo update-alternatives --install 添加选项，却漏掉 --config java 手动选择，或者没同时注册 javac、jar 等关联命令，导致编译时用的是 JDK 17，打包时却调了 JDK 11 的 jar。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 为每个 JDK 安装项注册全部工具链：
sudo update-alternatives --install /usr/bin/java java /opt/jdk-17/bin/java 170 \ --slave /usr/bin/javac javac /opt/jdk-17/bin/javac \ --slave /usr/bin/jar jar /opt/jdk-17/bin/jar
- 切换前先确认所有关联命令已注册：
update-alternatives --list java和update-alternatives --list javac应返回相同优先级列表 - 切换后验证：
java -version、javac -version、readlink -f $(which java)三者必须指向同一 JDK 根目录
IDE 和构建工具如何避开全局 JDK 冲突
即使终端里 java -version 显示正确，IntelliJ、VS Code 或 Maven 仍可能用错 JDK —— 因为它们往往忽略 shell 的 JAVA_HOME，而读取自身配置或 pom.xml 中的 maven-compiler-plugin 设置。典型现象是：命令行编译成功，IDE 报 “Unsupported class file major version 65”（即用了 JDK 21 编译，但 IDE 默认用了 JDK 11 运行）。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：File → Project Structure → Project Settings → Project → SDK，选对应 JDK；再进 Modules → Sources → Language level，确保与 SDK 匹配
- Maven：在
pom.xml中显式声明编译目标：<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> - Gradle：在
gradle.properties中设org.gradle.java.home=/path/to/jdk-17，比依赖JAVA_HOME更可靠
java、javac、IDE 启动、Maven 构建时，背后调用的二进制文件是否来自你明确指定的那个版本。最容易被忽略的是：构建工具和 IDE 的 JDK 设置彼此独立，且常常默认值滞后于系统最新安装版本。 
