IntelliJ IDEA中Java版本管理怎么做

IntelliJ IDEA 中的 Java 版本管理

一 核心概念与层级

• Project SDK：项目默认使用的 JDK，决定项目整体的编译与运行环境。
• Module SDK：单个模块的 JDK，优先级高于 Project SDK，适用于多模块项目中对不同模块使用不同 JDK 的场景。
• Project language level：代码语言特性级别（如 8/11/17/21），控制 IDE 的语法提示与检查。
• Project bytecode version：编译输出的字节码目标版本（应与运行 JDK 匹配）。
• IDE 运行 JDK：IntelliJ IDEA 自身运行所用的 JDK，影响 IDE 插件与性能，通常无需与项目一致。
• 构建工具配置：Maven（pom.xml） 与 Gradle（build.gradle） 中的 Java 版本声明，团队协作与 CI 一致性关键。
• 运行配置：Run/Debug Configurations 中的 JRE，可针对单个运行项覆盖 JDK。

二 在 IDEA 中设置与切换版本

• 添加与选择 JDK
  1. 打开 File → Project Structure（Ctrl+Alt+Shift+S）；2) 在 Platform Settings → SDKs → + → Add JDK，选择本地 JDK 根目录（应包含 bin、lib 等子目录）；3) 在 Project → Project SDK 选择刚添加的 JDK，并设置 Project language level；4) 在 Modules → Dependencies → Module SDK 为模块单独指定（多模块项目以模块为准）。
• 设置默认 JDK（影响新建项目）
  进入 File → New Projects Setup → Settings for New Projects，按上一步为 Project SDK/Language level 设定默认值。
• 编译器字节码版本
  打开 Settings → Build, Execution, Deployment → Compiler → Java Compiler，设置 Project bytecode version 与模块级字节码版本，确保与运行 JDK 兼容。
• 运行配置 JRE
  在 Run/Debug Configurations → JRE 指定运行所用的 JDK/JRE，可覆盖项目/模块设置。
• 常见校验
  在终端执行 $JAVA_HOME/bin/java -version 与 $JAVA_HOME/bin/javac -version 均应成功；IDEA 添加 JDK 时必须指向 JDK 根目录，不可选 JRE 或 bin 子目录。

三 与构建工具和运行时的协同

• Maven
  在 pom.xml 中声明 maven-compiler-plugin 的 source/target（或 release），保持与 IDE 的 Project bytecode version 一致；如使用 Maven Toolchain 可为不同 JDK 版本提供独立工具链。
• Gradle
  在 build.gradle 中设置 sourceCompatibility 与 targetCompatibility（Gradle 7+ 推荐 java toolchain），确保与 IDE 与运行环境一致。
• 环境变量与构建行为
  JAVA_HOME/PATH 不影响 IDEA 内部的 Project/Module SDK 选择，但会影响 Maven/Gradle 插件调用的 Java 版本；团队协作建议统一构建配置与 IDE 设置，避免“IDE 能跑、命令行构建失败”。

四 多版本共存与切换建议

• 多 JDK 管理
  在 SDKs 中添加多个 JDK，按需为项目/模块切换；多模块项目优先检查各模块的 Module SDK。
• 命令行与 IDE 一致
  使用 SDKMAN!（macOS/Linux）或 JEnv（macOS/Linux）管理系统级多版本，命令行的 java -version 与 IDE 的 Project SDK 保持一致，减少环境差异。
• 快速排查清单
  1. 项目/模块 SDK 是否正确；2) Language level 与 字节码版本 是否匹配；3) 构建文件（Maven/Gradle）版本声明是否一致；4) 运行配置 的 JRE 是否覆盖；5) 终端 java/javac 是否能正常执行。