JDK多版本共存关键在于环境变量设计：需通过可切换的JAVA_HOME动态控制PATH，避免硬编码路径；各版本分目录安装，禁用安装器自动加PATH；用批处理或shell函数切换JAVA_HOME；IDE独立配置SDK；验证时需核对JAVA_HOME、which/where java及PATH纯净性。
JDK 多版本共存不难，关键在环境变量设计得当——不要只配一个 JAVA_HOME，而要让 JAVA_HOME 可切换；PATH 里不能硬写死路径，必须依赖 JAVA_HOME 动态引用。否则装多个 JDK 后，java -version 总是显示同一个版本，或者 javac 找不到命令，本质都是 PATH 指向了错误的 bin 目录。
分目录安装，路径清晰不混杂
每个 JDK 版本单独安装到不同文件夹，推荐统一前缀便于识别：
- 比如 C:\dev\jdk8、C:\dev\jdk17、C:\dev\jdk25（Windows）
- macOS/Linux 可放在 /Library/Java/JavaVirtualMachines/jdk-8.0.421.jdk 或 ~/jdk/jdk-17.0.12 这类结构化路径
- 安装时勾选“Add to PATH”务必取消——避免安装器自动写死 PATH，干扰后续手动控制
只配一次 JAVA_HOME，但用脚本或工具动态切换
系统级 JAVA_HOME 保持为空或指向默认版本，实际开发中靠轻量方式切换：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- Windows：写几个批处理，如 use-jdk8.bat 内容为
setx JAVA_HOME "C:\dev\jdk8" & setx PATH "%JAVA_HOME%\bin;%PATH%" - macOS/Linux：在 ~/.zshrc 中定义函数：
jdk8() { export JAVA_HOME=$HOME/jdk/jdk8; export PATH=$JAVA_HOME/bin:$PATH; }，终端输入jdk8即刻生效 - IDE（IntelliJ IDEA / Eclipse）独立配置 SDK：Project Structure → Project Settings → Project SDK，按项目指定 JDK，不依赖系统 JAVA_HOME
验证与排错重点看这三处
运行 java -version 和 javac -version 不一致？说明 PATH 里混进了不同 JDK 的 bin：
- 先查
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），确认值是否为你期望的路径 - 再查
where java（Windows）或which java（macOS/Linux），看实际调用的是哪个 java 可执行文件 - 最后检查 PATH 中是否有多余的 JDK bin 路径（比如旧版残留），删掉所有显式写死的 JDK 路径，只保留
%JAVA_HOME%\bin或$JAVA_HOME/bin
团队协作建议统一管理方式
多人共用一套配置时，避免各自改环境变量导致不一致：
- 用 SDKMAN!（macOS/Linux）或 jEnv（macOS）这类工具统一管理，命令行一键切换：
sdk use java 25.0.2-amzn - Windows 团队可共享一个 PowerShell 切换脚本，配合 Git Hooks 自动加载项目所需的 JDK 版本
- 构建工具层面加固：Maven 的
maven-compiler-plugin显式声明 source/target，Gradle 的java.toolchain指定语言版本，不依赖系统默认 JDK
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
