多版本JDK共存问题源于环境变量未分层隔离；需系统级设JAVA_HOME为默认JDK、项目级用jenv注册并rehash、IDE直配真实JDK路径、Docker用镜像固化版本。
多版本JDK共存时，命令行执行 java -version 显示的版本与项目实际需要的版本不一致，IDE报“Unsupported major.minor version”，Maven编译失败却查不到Java路径错误根源——这些问题都源于环境变量未按分层逻辑隔离配置。
系统级基础环境：只设JAVA_HOME指向默认JDK
这一步是所有后续配置的前提，必须严格限定为单一、稳定、可验证的默认JDK。不要把多个JDK路径塞进PATH，也不要让JAVA_HOME指向软链接或脚本。
第一步：确认一个明确的默认JDK安装路径，例如 【/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home】（macOS）或 【C:\Program Files\Java\jdk-17】（Windows）。
第二步：设置系统级JAVA_HOME变量，值为上一步确认的完整路径；PATH中仅添加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）。
第三步：重启终端或运行 source ~/.zshrc（macOS）或 refreshenv（Windows PowerShell），再执行 java -version 和 echo $JAVA_HOME 验证是否输出一致且无误。
项目级动态切换：用jenv管理多版本（macOS/Linux）
jenv不是自动发现工具，它靠显式注册+垫片拦截实现命令重定向，跳过这一步直接切版本必然失败。
方法一：注册已安装的JDK
执行 jenv add /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home（M芯片macOS），或 jenv add /usr/lib/jvm/java-11-openjdk-amd64（Ubuntu）。每装一个新JDK都必须重新运行一次 jenv add。
方法二：全局/本地版本绑定
在项目根目录下运行 jenv local 21，jenv会在当前目录生成 .java-version 文件，下次进入该目录时自动激活JDK 21；若想全局生效，用 jenv global 17。
注意：【每次执行 jenv add 或 jenv global/local 后，必须立即运行 jenv rehash】，否则 shell 找不到 java/javac 命令，提示 “command not found”。
IDE专属绑定：绕过系统环境变量直连JDK路径
IntelliJ IDEA、VSCode、Eclipse等工具不读取shell中的JAVA_HOME，它们依赖自身配置的SDK路径。系统里jenv切得再准，IDE里没配对照样报错。
在IntelliJ IDEA中：File → Project Structure → Project → Project SDK → 点击右侧齿轮图标 → Add JDK → 选择 【/Library/Java/JavaVirtualMachines/jdk-11.0.20.jdk/Contents/Home】 这类真实路径，不要选 /usr/bin/java。
在VSCode中：打开工作区根目录下的 .vscode/settings.json，写入：
{ "java.home": "/Library/Java/JavaVirtualMachines/jdk-11.0.20.jdk/Contents/Home" }
这一步操作起来很简单，直接把文件拖进去就行。但必须确保路径末尾不含 /bin，否则Java扩展会启动失败。
Docker容器内隔离：用镜像固化JDK版本
当宿主机存在多个JDK时，容器内必须彻底切断与宿主JAVA_HOME的关联，否则docker exec进去看到的还是宿主默认版本。
方法一：使用官方Temurin镜像（推荐）
在Dockerfile中写死基础镜像，例如 FROM eclipse-temurin:11-jre-jammy 或 FROM eclipse-temurin:21-jre-jammy，无需额外配置JAVA_HOME，镜像内部已预置完整环境。
方法二：手动安装JDK并覆盖JAVA_HOME
若必须基于alpine或scratch构建，先用apk add openjdk11，再在Dockerfile末尾添加 ENV JAVA_HOME=/usr/lib/jvm/java-11-openjdk 和 ENV PATH=$JAVA_HOME/bin:$PATH。
构建后验证：运行 docker run --rm myapp:jdk11 java -version，输出必须为11.x，且不能出现“openjdk version”以外的干扰信息。
