@SupportedSourceVersion用于声明注解处理器支持的Java源码版本，推荐使用注解方式（如@SupportedSourceVersion(SourceVersion.RELEASE_17)）而非重写方法，且必须与项目sourceCompatibility一致，否则可能导致处理器被javac跳过或解析失败。
在 Java 注解处理器（APT）中，@SupportedSourceVersion 是一个元注解，用于声明该处理器能处理的 Java 源码版本。它直接告诉 javac：“我只支持解析这个版本及以下的源代码”，避免在不兼容的 JDK 环境下被错误调用或静默失效。
怎么指定支持的 Java 版本
有两种等效方式，推荐使用注解方式，更清晰、不易出错：
- 在处理器类上直接加
@SupportedSourceVersion，传入SourceVersion枚举值，例如：@SupportedSourceVersion(SourceVersion.RELEASE_17) - 或者重写
getSupportedSourceVersion()方法，显式返回枚举值：@Override public SourceVersion getSupportedSourceVersion() { return SourceVersion.RELEASE_21; }
注意：两个方式不能混用。如果都写了，以 @SupportedSourceVersion 注解为准；若都没写，AbstractProcessor 默认返回 RELEASE_6（即 Java 6），这在现代项目中极易导致注解不生效——尤其当你用了 record、sealed 或 switch 表达式等新语法时。
常见可选值与对应 Java 版本
SourceVersion 枚举从 RELEASE_6 开始，一直支持到最新版。常用值包括：
立即学习“Java免费学习笔记（深入）”；
-
RELEASE_8→ Java 8（Lambda、接口默认方法） -
RELEASE_11→ Java 11（LTS，模块系统稳定） -
RELEASE_17→ Java 17（LTS，密封类、模式匹配预览） -
RELEASE_21→ Java 21（LTS，虚拟线程、记录模式、switch 模式匹配正式）
选哪个？建议和你项目实际使用的 sourceCompatibility 保持一致。比如 build.gradle 中设了 java.sourceCompatibility = JavaVersion.VERSION_17，那处理器就该用 RELEASE_17。
为什么必须显式指定
原因有三：
- 编译器校验机制：javac 在启动处理器前会检查版本兼容性，不匹配则跳过该处理器，且通常不报错——导致注解“看起来没反应”
-
Element API 行为差异：不同 Java 版本引入的新语言特性（如
sealed类）需要对应版本的Element解析能力，旧版本处理器可能无法识别或解析失败 -
避免误用：比如你在 Java 21 项目里用了
RELEASE_8，处理器可能无法正确读取record字段的类型信息，生成代码出错
搭配 @AutoService 的注意事项
如果你用 @AutoService(Processor.class) 自动注册处理器（推荐），@SupportedSourceVersion 仍需显式标注。AutoService 只负责生成 META-INF/services/... 文件，不干涉版本声明逻辑。漏掉它，即使注册成功，也可能因版本不匹配而被 javac 忽略。
