教程:为什么没有声明 @Retention 的注解默认只能留在源码期

夏婷酱_2476

夏婷酱_2476

2026-06-02

583人浏览

原创

@retention默认策略是retentionpolicy.class,注解写入.class文件但运行时不可见;source需显式声明,仅存于源码;runtime支持反射读取。

教程:为什么没有声明 @retention 的注解默认只能留在源码期

不是这样。没有声明 @Retention 的注解,默认保留策略是 RetentionPolicy.CLASS,不是 SOURCE。

默认值其实是 CLASS,不是 SOURCE

Java 规范明确规定:如果自定义注解未显式使用 @Retention,它的保留策略默认为 RetentionPolicy.CLASS。这意味着注解会写入 .class 文件,但 JVM 在运行时不会加载它,反射也读不到。

  • 比如你写:
    @interface MyAnno { String value() default ""; }
    ——它等价于 @Retention(RetentionPolicy.CLASS)
  • RetentionPolicy.SOURCE 只用于明确需要“编译即丢”的场景,如 @Override,但它本身是由 JDK 预定义并显式标注了 @Retention(SOURCE) 的
  • 没有任何内置或自定义注解在未加 @Retention 时会自动变成 SOURCE

为什么有人误以为默认是 SOURCE?

常见误解来源有三个:

Synthesys
Synthesys

Synthesys是一款提供 AI 配音、数字人视频和图像生成的内容创作平台。

下载
  • 看到 @Override 这类注解在运行时反射不到,就推断“没写 @Retention 就是 SOURCE”——其实它是显式声明为 SOURCE 的
  • 混淆了“IDE 或编译器能识别”和“注解是否保留在字节码中”:SOURCE 注解只对 javac 和 IDE 有效,CLASS 注解对 javac 和字节码工具(如 ASM)有效,但对反射无效
  • 某些旧资料或博客错误表述,把“不写 @Retention → 编译器不报错 → 像没用一样”等同于“只在源码存在”,忽略了它实际已进入 .class

怎么验证默认确实是 CLASS?

你可以用 javap 反编译验证:

  • 定义一个无 @Retention 的注解:
    @interface Loggable {}
  • 编译后执行:javap -v Loggable.class | grep -A5 "RuntimeVisibleAnnotations"
  • 会看到类似 RuntimeVisibleAnnotations 属性(说明注解进了 class 文件),但运行时调用 getAnnotation(Loggable.class) 仍返回 null ——这正是 CLASS 策略的行为

什么时候才真正是 SOURCE?

只有显式写成这样,才是真正的源码期注解:

@Retention(RetentionPolicy.SOURCE)<br>@interface CompileOnly { String value(); }

这种注解:

  • 不会出现在 .class 文件里(javap 查不到)
  • 编译完就彻底消失,连字节码工具都看不到
  • 适合纯编译检查或 Lombok 类生成器——它们在编译阶段介入,不需要运行时存在

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9657

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6802

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6012

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1044

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

868

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1276

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2529

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19871

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1135

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
全面解析Java注解
全面解析Java注解

共12课时 | 3.3万人学习

Java 教程
Java 教程

共578课时 | 189万人学习

JAVA教程手册
JAVA教程手册

共70课时 | 98.1万人学习