Java注解与元注解的语法基础

P粉602998670

发布时间：2026-01-09 16:35:46

752人浏览过

来源于php中文网

原创

注解声明必须用@interface而非interface，自动继承annotation接口；成员只能是无参方法，返回值限基本类型、string、class、枚举、注解及对应数组；@target和@retention需配对使用，runtime保留策略方可反射获取；成员默认值须用default关键字指定。

java注解与元注解的语法基础

注解声明必须用 `@interface`，不是 `interface`

Java 注解本质是接口的特殊形式，但语法上不能写成普通接口。直接写 interface MyAnnotation 会编译失败，必须加 @ 符号：@interface MyAnnotation。这个 @ 不是修饰符，而是语法标记，告诉编译器这是注解类型。

常见错误：把注解当成普通类或接口去继承、实现，或者漏掉 @ 导致 cannot find symbol 报错。

@interface 声明的类型自动继承 java.lang.annotation.Annotation，不可显式 extends 或 implements
注解内只能定义方法（即成员），不能有字段、构造器、静态块等
每个方法不能有参数，也不能有 throws 子句，返回值类型仅限：基本类型、String、Class、枚举、其他注解，或以上类型的数组

`@Target` 和 `@Retention` 是最常配对使用的元注解

没有 @Target，自定义注解默认可加在任意位置（类、方法、字段等），但多数场景需要限制作用域；没有 @Retention，注解默认只保留在源码阶段（RetentionPolicy.SOURCE），运行时无法反射读取——这点极易被忽略。

典型组合：

立即学习“Java免费学习笔记（深入）”；

微信小程序公众号SaaS管理系统

微信小程序公众号SaaS管理系统是一款完全开源的微信第三方管理系统，为中小企业提供最佳的小程序集中管理解决方案。可实现小程序的快速免审核注册（免300元审核费），可批量发布小程序模板，同步升级版本等功能。基础版本提供商城和扫码点餐两种小程序模板。商户端可以实现小程序页面模块化设计和自动生成小程序源代码并直接发布。

下载

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {
}

@Target 的值是 ElementType 枚举，常用值包括 TYPE（类）、METHOD、FIELD、PARAMETER、ANNOTATION_TYPE（用于元注解自身）
@Retention 决定注解生命周期：SOURCE（仅源码）、CLASS（字节码中存在但 JVM 不加载）、RUNTIME（可通过反射获取）
若要用 Class.getAnnotation() 或 Method.getAnnotation() 读取，@Retention 必须设为 RUNTIME

注解成员默认值必须用 `default` 关键字，且不能为 `null`

注解成员像方法一样声明，但支持默认值。不写 default 就是必填项；写了却没提供值，编译报错 annotation member must have a default value。更关键的是：基本类型不能设为 null，而引用类型默认值若不显式写 default null，编译器会拒绝（除非是数组，可写 default {}）。

@interface Retryable {
    String value() default "";
    int maxAttempts() default 3;
    Class<? extends Throwable>[] retryOn() default {};
    long backoffMs() default 1000;
}

字符串默认空串比 null 更安全，避免反射取值后 NPE
数组成员默认值必须写 default {}，不能省略或写 null
枚举、Class 类型成员可写 default Void.class 或 default MyEnum.DEFAULT，但不能写 default null（编译不通过）