本文旨在深入解析 Java 编译器中用于控制版本兼容性的关键选项，包括已弃用的 `-source` 和 `-target`，以及现代推荐的 `--release`。我们将探讨这些选项在限制语言特性、字节码格式和核心库依赖方面的作用，并强调 `--release` 如何作为统一解决方案，确保 Java 应用程序和库在不同 Java 运行时环境下的兼容性。
在 Java 开发中，确保代码在不同版本的 Java 运行时环境（JRE）中正确运行，是开发者面临的一个常见挑战。Java 编译器（javac）提供了一系列选项来管理这种兼容性，其中最核心的是控制源文件版本、字节码版本以及编译时所依赖的核心库版本。理解这些选项的工作原理及其演变，对于编写健壮且可移植的 Java 代码至关重要。
早期兼容性选项：-source 和 -target
历史上，javac 提供了 -source 和 -target 选项来处理版本兼容性问题。然而，这两个选项存在一些局限性，并最终被更现代的 --release 选项所取代。值得注意的是，这些选项的单破折号形式（如 -source）也已被双破折号形式（如 --source）取代，尽管单破折号在某些情况下仍被支持。
--source 选项：语言特性限制
--source 选项旨在指定编译器应接受的 Java 源代码版本。其核心目的是限制开发者使用指定版本之后引入的语言特性。例如，如果设置为 --source 1.5，编译器将只接受 JDK 5 中引入的特性及更早版本的特性。
立即学习“Java免费学习笔记（深入）”；
然而，--source 选项的实际工作方式并不像人们想象的那样。Java 语言规范并未为每个版本提供独立的解析器，javac 也不会为每个 Java 版本都内置一个独立的解析器。实际上，它更多地是作为一种标记机制，当检测到高于指定 source 版本的语言结构时，会将其标记为无效。这意味着，尽管编译器可能“理解”这些新结构，但会明确阻止其使用。
--target 选项：字节码格式版本
--target 选项用于控制生成的 Java 类文件的格式版本。不同的 Java 版本可能会引入新的字节码指令或类文件格式的更改。通过设置 --target，开发者可以确保生成的字节码能够被特定版本的 JRE 所识别和执行。
需要注意的是，--source 和 --target 之间存在严格的关系：--target 指定的版本必须至少与 --source 指定的版本相同。例如，--source 17 --target 16 这样的组合是无效的，因为目标字节码版本不能低于源语言版本。这是因为某些语言特性可能需要特定的字节码结构来支持，而这些结构在旧的字节码版本中可能不存在。
缺失的一环：核心库兼容性
仅仅通过 --source 和 --target 来控制兼容性是不够的。即使你将源代码和字节码版本都设置为较低的版本，如果你的代码使用了高版本 JDK 中引入的新的核心库（即 java. 包下的类），那么在旧版本的 JRE 上运行时仍然会遇到问题。例如，如果你在 JDK 15 环境下开发，并使用了 JDK 15 中新增的 java.lang 类，然后使用 javac --source 14 --target 14 进行编译，代码可能看似编译成功。但当尝试在 JDK 14 的 JRE 上运行时，由于缺少相应的核心库类，程序会抛出 NoClassDefFoundError 或类似错误。
为了解决这个问题，开发者需要通过设置编译器的 bootclasspath 来指定编译时所依赖的核心库版本。这意味着你需要为每个目标 JRE 版本都安装一个相应的 JDK，并手动配置 javac 以针对该 JDK 的核心库进行编译，这无疑增加了复杂性。
现代解决方案：--release 选项
为了简化和统一 Java 编译器的版本兼容性控制，JDK 9 引入了 --release 选项。--release 是一个综合性的选项，它有效地替代了 --source 和 --target，并自动处理了核心库的兼容性问题。
当使用 --release N 时，javac 会自动执行以下操作：
- 将 --source 设置为 N。
- 将 --target 设置为 N。
- 最重要的是，它会配置编译器，使其仅能访问 JDK N 版本的核心库 API。这意味着你无需手动设置 bootclasspath，编译器会确保你的代码不会意外地使用高于目标版本的核心库特性。
为什么需要限制版本？
限制编译器的目标版本，尤其是使用 --release 选项，对于以下场景至关重要：
- 库开发： 如果你正在开发一个供其他开发者使用的 Java 库，你可能希望它能在更广泛的 JRE 版本上运行。通过将库编译到较低的 release 版本（例如 --release 11），你可以确保使用 JDK 11 或更高版本的用户都能顺利地将你的库作为依赖项使用。
- 企业环境： 在大型企业中，生产环境的 JRE 版本可能更新较慢。为了确保应用程序在现有生产环境中能够稳定运行，开发者通常需要将代码编译到与生产环境 JRE 兼容的版本。
- 兼容性测试： 在进行兼容性测试时，--release 选项可以帮助模拟不同 JRE 环境下的编译和运行行为。
示例代码
以下是如何使用 javac 的 --release 选项进行编译的示例：
// MyApplication.java
public class MyApplication {
public static void main(String[] args) {
System.out.println("Hello from Java!");
}
}要将 MyApplication.java 编译为可在 Java 11 JRE 上运行的字节码，即使你当前使用的是 JDK 17：
javac --release 11 MyApplication.java
这将生成一个 MyApplication.class 文件，其字节码版本为 55.0（对应 Java 11），并且确保代码中没有使用任何 Java 11 之后引入的语言特性或核心库 API。
总结与最佳实践
--release 选项是现代 Java 开发中管理版本兼容性的首选方式。它提供了一个统一且简化的机制，确保你的代码在指定的目标 JRE 版本上能够正确编译和运行，同时避免了 source 和 target 选项以及手动 bootclasspath 配置的复杂性。
关键建议：
- 优先使用 --release： 除非有非常特殊的需求，否则应始终使用 --release 选项来控制编译器的版本兼容性。
- 根据目标环境选择版本： 在选择 --release 的版本时，应考虑你的应用程序或库需要支持的最低 JRE 版本。
- 避免混合使用： 不要同时使用 --release 和旧的 --source/--target 选项，这可能导致混淆或意外行为。
通过熟练掌握 --release 选项，Java 开发者可以更有效地管理项目依赖，确保代码的向后兼容性，从而构建更健壮、更灵活的 Java 应用程序和库。
