@SuppressWarnings 是 SOURCE 级注解，仅在编译期生效，用于抑制 javac 的特定 lint 警告，不进入字节码，运行时不可见，也无法通过反射获取。
@SuppressWarnings 属于 SOURCE 级保留策略（RetentionPolicy.SOURCE），也就是说，它只在源代码阶段存在，编译完成后就不再保留在字节码（.class 文件）中，运行时完全不可见。
为什么是 SOURCE 级？
这个注解的使命非常明确：仅用于影响 javac 编译器的 lint 检查行为。它不参与运行逻辑，也不需要被反射读取或在 JVM 中生效。一旦编译完成，它的任务就结束了。
你可以通过查看其源码确认：
public @interface SuppressWarnings { ... }该注解类上标注了 @Retention(RetentionPolicy.SOURCE)，这是 Java 标准库的明确定义。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
在编译时起什么作用？
它告诉 javac 编译器：「对当前元素及其内部所有嵌套元素，暂时关闭指定类型的 lint 警告」。
- 不是屏蔽错误（error），错误仍会导致编译失败；
- 只是让编译器跳过对某段代码执行特定静态检查（如泛型擦除后的类型安全、未使用变量、过时 API 调用等）；
- 抑制范围遵循就近原则——标在方法上，就只影响该方法；标在局部变量上，就只影响该变量声明及后续直接相关语句；
- 多个警告类型可合并指定，例如
@SuppressWarnings({"unchecked", "unused"})。
它和运行时无关
由于不进入字节码，你无法通过 Class.getDeclaredAnnotations() 或任何反射方式获取它；Spring、JUnit、Lombok 等框架也都不依赖它做运行时处理。它的全部价值，就体现在你写完代码按下编译那一刻——让真正值得关注的 warning 留下来，把已知无害、暂时无法消除的 warning 沉下去。
