如何确保继承自基类的子类均被@dataclass装饰？

你遇到的问题核心确实是类继承逻辑先于装饰器执行：Python会先创建子类对象、触发基类的__init_subclass__，之后才会应用@dataclass装饰器，所以此时检查is_dataclass()自然会返回False。下面给你几个实用的解决方案，你可以根据需求选择：

方案1：实例化时检查（简单直接） #

把检查逻辑延迟到子类第一次实例化时执行，此时@dataclass已经完成装饰。这个方案实现最简单，唯一的小缺点是错误会在实例化时才抛出，而不是类定义阶段。

from dataclasses import dataclass, is_dataclass

class Base:
    def __init__(self, *args, **kwargs):
        # 检查当前实例所属的类是否是dataclass
        if not is_dataclass(self.__class__):
            raise ValueError(f"子类 {self.__class__.__name__} 必须使用@dataclass装饰")
        # 调用父类的初始化方法（确保继承链正常工作）
        super().__init__(*args, **kwargs)

# 正确用法示例
@dataclass
class Child(Base):
    name: str

# 错误用法示例（实例化时会触发异常）
class BadChild(Base):
    pass

# 测试
child = Child(name="Alice")  # 正常运行
bad_child = BadChild()       # 抛出ValueError

方案2：类定义后延迟检查（类定义阶段报错） #

利用元类结合线程延迟执行，确保在@dataclass装饰器运行完成后再检查子类是否符合要求。这个方案能在类定义后尽快抛出错误，但依赖线程定时器，错误抛出时机略有延迟。

from dataclasses import dataclass, is_dataclass
import threading

class BaseMeta(type):
    def __init__(cls, name, bases, attrs):
        super().__init__(name, bases, attrs)
        # 只检查继承自Base的类，排除Base自身
        if Base in bases or any(issubclass(b, Base) for b in bases):
            def validate_dataclass():
                if not is_dataclass(cls):
                    raise ValueError(f"类 '{name}' 继承自Base但未使用@dataclass装饰")
            # 延迟0秒执行，确保@dataclass装饰器已完成工作
            threading.Timer(0.0, validate_dataclass).start()

class Base(metaclass=BaseMeta):
    pass

# 正确用法示例
@dataclass
class Child(Base):
    name: str

# 错误用法示例（类定义后立即抛出ValueError）
class BadChild(Base):
    pass

方案3：自定义装饰器（强制规范用法） #

编写一个自定义装饰器，既自动应用@dataclass，又强制检查类是否继承自Base。这个方案从根源上避免子类忘记使用装饰器的问题，但需要子类使用你定义的装饰器而非原生@dataclass。

from dataclasses import dataclass, is_dataclass

def base_dataclass(cls):
    # 先检查类是否继承Base
    if not issubclass(cls, Base):
        raise ValueError("这个装饰器只能用于Base的子类")
    # 应用原生dataclass装饰器
    cls = dataclass(cls)
    return cls

class Base:
    pass

# 正确用法示例
@base_dataclass
class Child(Base):
    name: str

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