IDEA新建项目时的“Project SDK”和“Java”有何区别？

一、快速理解

在 IDEA 创建项目时，会有这个下图的选项：这两个有什么区别呢？

1、Java 选项是语法的版本，是让你选择项目里会用到的语言特性；

2、Project SDK 选项是Java程序运行环境的版本，是实际用到的JDK，你看它是显示全了版本号的。

3、注意：一般来说语言特性不能比 SDK 高。比如 SDK 版本是8，语言选 11 就有问题了。

二、详细理解

1、Java 选项（Language Level）——语法和语言特性版本

Java 选项（Language Level）决定了项目中可以使用的 语言特性。

例如 lambda 表达式、模块化系统（Java 9 的模块化特性）、switch 表达式（Java 12）等。它表示你希望使用的 Java 语法级别和功能支持，而与底层的运行环境（JDK）暂时无关。

举例说明：
如果选择了 Java 11 作为语言级别，那么你可以在代码中使用 Java 11 的新特性，例如 var 关键字。
如果选择 Java 8，则只能使用 Java 8 或之前的特性，如默认方法（Default Methods）或 lambda 表达式。

作用场景：

• 控制项目中代码的可用语法。 编译器会根据这个选项判断是否允许某些语法出现。例如，如果项目设置为 Java 8，你尝试使用 Java 11 的 var 关键字，IDE 会提示语法错误。

2、Project SDK —— 程序运行的 JDK 版本

Project SDK 决定了项目编译和运行所依赖的 Java 开发工具包（JDK） 版本，是程序执行的实际环境。SDK 包含 Java 的核心库、JVM、编译器和其他工具，确保代码能正常编译和运行。

特点：

• 版本完整性：项目 SDK 会显示完整的 JDK 版本号，例如 jdk-11.0.16 或 jdk-17.0.2。
• 运行环境：即使语言级别支持某些新特性，SDK 也需要能够兼容这些特性，否则程序将无法正确运行。

作用场景：提供实际的编译和运行环境。确保项目在生产或开发环境中的行为与 IDE 中一致。

3、二者关系与注意事项

Java 选项和 Project SDK 是两个互相关联但不相同的配置。通常情况下，语言级别（Java 选项）不能高于 SDK 的版本，否则会导致问题。例如：

1、正确配置：
如果 Project SDK 设置为 Java 11，则可以选择 Java 8、Java 9、Java 10 或 Java 11 作为语言级别。
如果 Project SDK 设置为 Java 17，则可以选择 Java 17 或以下的语言特性。

2、错误配置：
如果 Project SDK 是 Java 8，但语言级别选择了 Java 11，则项目编译时可能会报错，提示不支持的语言特性。
这种情况下，IDE 无法提供相应语言特性的支持，因为底层运行环境的版本不够高。

4、如何正确配置

在配置项目时，应根据实际需要选择合适的语言级别和 SDK：

1、优先考虑兼容性：确保语言级别和 SDK 一致。如果项目的运行环境限制在 Java 8，那么语言级别也应限制为 Java 8。
2、合理利用新特性：在满足项目运行环境要求的基础上，优先选择较高版本的语言级别，以便利用更新的语法和特性提高开发效率。
3、团队协作需求：如果项目由多个开发者协作开发，确保每个人的环境（SDK 和语言级别）一致，避免因版本不一致导致的问题。

5、常见问题与解答

问题 1：SDK 设置为 Java 11，但语言选项选择 Java 17，编译报错。
原因：Java 11 SDK 不支持 Java 17 的语言特性，例如 sealed 类。 解决办法：将语言选项调整为 Java 11 或升级 SDK 至 Java 17。

问题 2：设置了正确的语言和 SDK，但仍无法使用某些特性。
原因：可能是 IDE 配置未同步或构建工具（如 Maven/Gradle）配置未更新。 解决办法：确保构建工具的 Java 版本设置与 IDE 配置一致。

问题 3：运行时提示版本不兼容。
原因：可能是目标环境的 JRE 版本过低。 解决办法：将项目构建的目标版本（Target Compatibility）设置为目标环境支持的版本。