为什么Python子类未继承父类的类注解？如何实现该继承效果？

这个现象是Python类注解的默认存储机制和属性查找规则共同导致的，核心逻辑非常明确：

• 每个类在定义过程中，解释器会为其独立维护一个专属的__annotations__字典，用来收集当前类体中直接声明的变量注解，类创建完成后不会自动合并父类的注解内容。
• 只要类体中存在任意一条注解声明，解释器就会把这个独立收集的__annotations__字典写入当前类的__dict__中。这个行为等价于开发者手动在类体里定义了__annotations__ = {当前类收集的注解}，会直接遮挡从父类继承来的同名属性。此时直接访问子类.__annotations__时，会优先命中子类自身__dict__里的这个条目，不会沿着方法解析顺序（MRO）向上查找父类的注解，自然就看不到父类的注解内容。

补充一个容易造成认知偏差的特殊场景：如果子类类体中完全没有写任何注解声明，那么子类的__dict__里根本不会生成__annotations__键，此时访问子类的__annotations__反而会通过常规的属性查找链拿到父类的注解，这种不一致的表现也是很多开发者对该行为感到困惑的原因。

方案1：元类自动合并 #

元类可以在类创建阶段拦截创建流程，自动对所有关联类生效，是全局统一处理注解继承的低侵入方案，实现代码如下：

class AnnotationInheritor(type):
    def __new__(cls, name, bases, namespace):
        # 先完成类的常规创建流程
        new_cls = super().__new__(cls, name, bases, namespace)
        merged_annotations = {}
        # 倒序遍历MRO，从最顶层基类开始逐层合并，保证子类注解优先级最高
        for base in reversed(new_cls.__mro__):
            if hasattr(base, '__annotations__'):
                merged_annotations.update(base.__annotations__)
        # 将合并完成的字典赋值给当前类的注解属性
        new_cls.__annotations__ = merged_annotations
        return new_cls

# 定义类时指定元类即可
class A(metaclass=AnnotationInheritor):
    valA: int

class B(A):
    valB: str

print(B.__annotations__)
# 输出：{'valA': <class 'int'>, 'valB': <class 'str'>}

该实现通过倒序遍历MRO的方式，保证子类自身定义的同名字段注解会覆盖父类的同名注解，和常规继承的优先级逻辑保持一致。

方案2：类装饰器手动合并 #

如果不需要全局生效的逻辑，仅需对特定类处理，可以用类装饰器实现相同的合并逻辑，灵活度更高：

def inherit_annotations(cls):
    merged_annotations = {}
    for base in reversed(cls.__mro__):
        if '__annotations__' in base.__dict__:
            merged_annotations.update(base.__annotations__)
    cls.__annotations__ = merged_annotations
    return cls

@inherit_annotations
class A:
    valA: int

@inherit_annotations
class B(A):
    valB: str

print(B.__annotations__)
# 输出同样为合并后的完整注解字典

实现注意事项 #

• 合并注解时不要直接引用父类的__annotations__字典，避免后续修改子类注解时意外改动父类的注解内容。
• 保持“子类注解优先于父类”的优先级逻辑，避免注解覆盖行为和常规类继承逻辑不一致。

内容的提问来源于stack exchange，提问作者chila