多Java版本共存时应通过隔离JDK路径并动态配置JAVA_HOME和PATH来切换，推荐使用sdkman工具管理，同时需同步配置IDE及Maven/Gradle构建工具。
在多 Java 版本共存的开发环境中，切换版本的关键不在于反复卸载重装，而在于合理隔离 JDK 安装路径，并通过环境变量或工具动态控制 JAVA_HOME 和 PATH 的指向。核心思路是：**让系统“知道”多个 JDK 在哪，再按需选择用哪一个**。
手动管理：靠环境变量精准切换
适用于轻量使用、对自动化要求不高的场景。前提是各 JDK 已独立安装（如 /usr/lib/jvm/java-8-openjdk-amd64、/usr/lib/jvm/java-17-openjdk-amd64）。
- 检查已安装 JDK 路径：Linux/macOS 可执行
ls /usr/lib/jvm/；Windows 可查看C:\Program Files\Java\ - 临时切换（当前终端生效）：
Linux/macOS：export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 && export PATH=$JAVA_HOME/bin:$PATH
Windows（CMD）：set JAVA_HOME=C:\Program Files\Java\jdk-17.0.1 && set PATH=%JAVA_HOME%\bin;%PATH% - 永久切换（推荐为不同项目写启动脚本）：避免全局修改
~/.bashrc或system.properties，而是为每个项目维护专属的java-env.sh或 IDE 运行配置
工具化管理：sdkman（Linux/macOS 主流选择）
sdkman 是专为 JVM 生态设计的版本管理器，支持 Java、Gradle、Maven 等多套件，安装和切换极简。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 一键安装（终端执行）：
curl -s "https://get.sdkman.io" | bash，然后重启终端或运行source "$HOME/.sdkman/bin/sdkman-init.sh" - 列出可用 Java 版本：
sdk list java（含 vendor 标识，如temurin-11.0.22+7、liberica-21.0.3+9） - 安装并设为默认：
sdk install java 17.0.1-temurin && sdk default java 17.0.1-temurin - 按项目局部指定：
sdk use java 11.0.22-temurin（仅当前 shell 有效），配合.sdkmanrc文件可实现目录级自动切换
IDE 集成：别只信终端，更要配对 IDE
终端切换了 Java 版本，IDE（如 IntelliJ IDEA、Eclipse、VS Code）仍可能沿用旧配置，导致编译/运行结果不一致。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ IDEA：File → Project Structure → Project → Project SDK → 点击 “+” 添加已安装 JDK 路径，再下拉选择目标版本
- Eclipse：Preferences → Java → Installed JREs → Add… → Standard VM → 指向 JDK 根目录；再在项目 Properties → Java Build Path → Libraries → JRE System Library 中切换
- VS Code + Extension（如 Extension Pack for Java）：打开命令面板（Ctrl+Shift+P），输入 “Java: Configure Java Runtime”，可分别设置项目 SDK、测试运行时、Maven 编译器等
构建工具协同：确保 mvn/gradle 用对 JDK
Maven 和 Gradle 默认使用 JAVA_HOME，但也可显式指定。尤其当 CI/CD 流水线或本地多版本混用时，建议显式声明。
- Maven：在
pom.xml中配置maven-compiler-plugin，明确source和target（如17），同时确保MAVEN_OPTS不强制覆盖 JVM 版本 - Gradle：在
gradle.properties中设org.gradle.java.home=/path/to/jdk-17，或在build.gradle中用java.toolchain.languageVersion = JavaLanguageVersion.of(17)（Gradle 17+） - 验证方式：执行
mvn -v或gradle -v，输出中 “Java version” 行应与预期一致
