JetBrains IDE 怎么让不同项目使用不同 JDK

可以做到，而且不需要反复修改系统级 JAVA_HOME。JetBrains IDE 会把 JDK 作为可复用的 SDK 注册到本机，然后由每个项目单独选择 Project SDK；多模块项目还可以在模块级覆盖，Gradle 项目则要另外确认 Gradle JVM。这样，老项目可以继续使用 JDK 17，新项目使用 JDK 21，两个窗口之间互不影响。

一、先把多个 JDK 加入 JetBrains IDE

以 IntelliJ IDEA 为例，打开 File | Project Structure，在左侧进入 Platform Settings | SDKs。点击加号后，可以从 Detected SDKs 选择已经找到的 JDK；如果列表没有目标版本，选择 Add JDK from disk，指向 JDK 的 home 目录。不要选择只包含运行时文件的 JRE 目录，Java 项目编译通常需要完整 JDK。

这一步是全局注册，不等于把所有项目都切换到这个版本。SDK 记录的是 IDE 可使用的安装位置，后面每个项目仍然可以单独选用。建议把条目命名成容易识别的版本，例如 JDK 17、JDK 21，不要只留下含糊的目录名。

二、给每个项目设置自己的 Project SDK

打开项目后再次进入 File | Project Structure | Project Settings | Project，在 SDK 下拉框选择该项目需要的 JDK。比如项目 A 选择 JDK 17，项目 B 选择 JDK 21；两个项目可以同时打开，选择结果保存在各自的项目配置中。

如果项目刚导入或下拉框显示 ，先回到 SDKs 页面完成注册，再返回 Project 页面选择。设置后顺手看一眼 Language level：它控制编辑器允许的 Java 语法，不应因为 Project SDK 较新就自动把老项目的源码级别也升高。需要兼容旧运行环境时，SDK 版本、语言级别和编译目标应按项目要求分别确认。

三、多模块项目只在必要时覆盖 Module SDK

项目 SDK 是默认值，模块可以继承它。进入 Project Structure | Modules，选中具体模块后打开 Dependencies，查看 Module SDK。大多数模块保持 Project SDK 即可；只有兼容性确实不同的模块，才在这里改成另一套 JDK。

例如一个项目包含旧版报表模块和新版服务模块，可以让报表模块使用 JDK 17，服务模块使用 JDK 21。模块一旦指定了独立 SDK，就不会随着 Project SDK 自动变化，这正是常见的“我明明改了项目 JDK，某个模块仍然报错”的原因。排查时先看模块是否还显示 Project SDK，再决定是否需要解除覆盖。

四、Gradle JVM 要单独确认

如果项目由 Gradle 管理，打开 Settings | Build, Execution, Deployment | Build Tools | Gradle，在对应 Gradle project 的 Gradle JVM 中选择需要的 JDK，然后点击 Apply 或 OK，并执行一次重新同步。这个字段决定 IntelliJ IDEA 导入 Gradle 项目、执行 Gradle 任务时使用的 JVM。

Gradle 项目还可能在 gradle.properties 中设置 org.gradle.java.home，或者受到 JAVA_HOME、Gradle 工具链配置影响。看到“Project SDK 已经是 JDK 21，但 Gradle 仍用 JDK 17”时，不要只改 Project SDK，应按 Gradle JVM 的选择路径逐项检查。使用项目自带 Wrapper 也能固定 Gradle 版本，但它和 JDK 版本是两个不同的设置。

五、运行前检查配置有没有再次覆盖

最后点开右上角运行配置，检查 JRE 或运行时字段是否被固定成某个 JDK，同时确认 Use classpath of module 指向了正确模块。普通 IDEA 编译、Gradle 任务和应用启动可能走不同入口，所以“编辑器能补全”并不能证明最终运行一定使用了目标 JDK。

可以用这份短清单收尾：项目页面显示正确 Project SDK；关键模块没有意外的独立 SDK；Gradle 页面显示正确 Gradle JVM；运行配置绑定了正确模块；重新同步或启动后，错误信息不再指向旧 JDK。完成这些检查后，分别打开两个项目测试一次，确认切换窗口不会改变另一个项目的选择。

常见问题

不同项目能不能使用同一个 JDK？

可以。SDK 是 IDE 可复用的全局条目，多个项目可以选择同一个版本；只有项目配置中的 Project SDK 选择不同，才会表现为项目间使用不同 JDK。

为什么改了 Project SDK，Gradle 还是使用旧版本？

Gradle JVM 是单独的构建设置，也可能受到 org.gradle.java.home 或 JAVA_HOME 影响。先检查 Gradle 设置页，再检查项目配置和环境变量。

模块 SDK 应该一直手动指定吗？

不建议。没有特殊兼容需求时保留 Project SDK，项目级切换才能自然传递到所有模块；只有确需不同 JDK 的模块才建立覆盖。