Java类结构注解：如何正确使用@Inherited-java教程-PHP中文网

@inherited是修饰自定义注解的元注解，使该注解在类继承时自动传递给直接子类；需同时满足：注解自身声明@inherited、标注在类上、子类通过extends继承。

java类结构注解：如何正确使用@inherited

@Inherited 不是用来修饰 Java 类本身的，而是用来修饰**自定义注解类型**的元注解。它的作用很明确：让这个自定义注解在被用在某个类上时，能“自动传递”给该类的直接子类（仅限类继承，不适用于接口实现、方法或字段）。

必须满足的三个前提条件

只有同时满足以下三点，@Inherited 才会生效：

自定义注解本身必须显式声明 @Inherited 元注解
该自定义注解必须标注在类（class）上，不能标在方法、字段、参数等位置
子类必须通过 extends 继承父类，而不是 implements 接口，也不是组合或代理

@Inherited 不起作用的常见场景

这些情况哪怕加了 @Inherited 也完全无效：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

把注解标在父类的方法上 —— 子类重写该方法后，不会继承该注解
父类实现了某个接口，而接口上有注解 —— 接口上的注解永远不会被实现类继承
子类用 @Override 重写了父类方法，但没在子类方法上再加注解 —— 方法级注解不传递
使用 Lombok 的 @Data 或 Spring 的 @Component 等框架注解 —— 它们自身未声明 @Inherited，所以不可继承

典型使用示例

下面是一个可运行的最小验证逻辑：

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Tracked {
    String value() default "tracked";
}

@Tracked("base-config")
public class BaseService {}

public class UserService extends BaseService {} // 未显式标注 @Tracked

// 运行时可通过反射确认：
System.out.println(UserService.class.getAnnotation(Tracked.class).value()); 
// 输出："base-config" —— 继承成功