如何让所有子类必须实现基类中定义的类属性

这个需求我之前也碰到过，想要让子类强制实现基类的类属性，而不是用@property加抽象方法那种间接的方式对吧？下面给你几个实用的方案，涵盖运行时检查和静态分析提示：

方案一：用__init_subclass__实现运行时强制检查（Python 3.6+） #

这是最简洁的方式，不需要写复杂的元类，利用Python内置的__init_subclass__钩子，在子类创建时自动检查是否定义了action属性：

class BaseClass:
    action: str

    def __init_subclass__(cls, **kwargs):
        super().__init_subclass__(**kwargs)
        # 检查子类是否定义了字符串类型的action
        if not hasattr(cls, 'action') or not isinstance(cls.action, str):
            raise TypeError(f"子类 {cls.__name__} 必须定义字符串类型的类属性 'action'")

# 符合要求的子类
class ValidChild(BaseClass):
    action = "user_login"
    def dummy_method(self):
        pass

# 不符合要求的子类，在定义时就会抛出TypeError
class InvalidChild(BaseClass):
    def dummy_method(self):
        pass

这个方案的好处是在子类定义阶段就报错，而不是等到实例化的时候，能更早发现问题。

方案二：用元类实现更精细的控制 #

如果你需要更复杂的类创建逻辑，元类是个不错的选择，它能完全掌控类的生成过程：

from abc import ABCMeta

class BaseMeta(ABCMeta):
    def __new__(cls, name, bases, namespace):
        # 跳过基类本身的检查
        if bases != (object,):
            # 检查子类命名空间中是否存在action，且是字符串类型
            if 'action' not in namespace or not isinstance(namespace['action'], str):
                raise TypeError(f"子类 {name} 必须定义字符串类型的类属性 'action'")
        return super().__new__(cls, name, bases, namespace)

class BaseClass(metaclass=BaseMeta):
    action: str

# 正确示例
class CorrectChild(BaseClass):
    action = "data_process"

# 错误示例，定义类时直接报错
class WrongChild(BaseClass):
    def dummy_method(self):
        pass

方案三：结合静态分析工具提前报错（比如mypy） #

如果希望静态分析工具（如mypy、PyCharm）在编码阶段就提示错误，不需要等到运行时，可以用typing.Protocol或者抽象类属性：

用Protocol实现静态检查 #

from typing import Protocol, ClassVar

class BaseProtocol(Protocol):
    action: ClassVar[str]

# 如果子类没定义action，mypy会直接报错
class ChildClass(BaseProtocol):
    def dummy_method(self):
        pass

用抽象类属性（Python 3.10+） #

from abc import ABC, abstractproperty
from typing import ClassVar

class BaseClass(ABC):
    @abstractproperty
    def action(cls) -> ClassVar[str]:
        ...

# 必须定义action，否则mypy和运行时都会报错
class ChildClass(BaseClass):
    action = "file_upload"

总结一下：如果只需要运行时强制检查，__init_subclass__是最省心的选择；如果要兼顾静态分析提示，结合类型注解或Protocol能让代码更健壮。

备注：内容来源于stack exchange，提问作者Grant Culp