使用@abstractmethod能在实例化子类时立即报错,将问题拦截在源头;而手动抛NotImplementedError需执行到该方法才触发,排查成本更高。

为什么直接抛异常不如用 abc.abstractmethod
子类没实现关键方法时,等到运行时才报 AttributeError 或调用失败,排查成本高。用 abc.abstractmethod 能在实例化子类的瞬间就报错,把问题卡在源头——不是靠人记,是靠解释器拦。
常见错误现象:TypeError: Can't instantiate abstract class XXX with abstract method YYY,这其实是好事,说明机制生效了。
- 必须继承
ABC(或带metaclass=ABCMeta)才能启用抽象检查 -
@abstractmethod只能修饰方法、属性、property 的 getter,不能修饰普通函数或类方法(除非明确用@classmethod+@abstractmethod组合) - 抽象基类本身不能被实例化,哪怕它所有方法都已实现
怎么写一个带强制方法的抽象基类
核心就三步:导入、继承、标记。别漏掉 ABC 这个父类,否则 @abstractmethod 形同虚设。
from abc import ABC, abstractmethod
class DataProcessor(ABC):
@abstractmethod
def load(self, path: str) -> dict:
pass
@abstractmethod
def validate(self, data: dict) -> bool:
pass
注意:pass 是占位符,不能写具体逻辑;如果写了,子类继承后不重写,调用的仍是父类空实现——这违背强制目的。
立即学习“Python免费学习笔记(深入)”;
- 参数签名(包括类型提示)不会被强制校验,Python 不检查子类方法是否和抽象方法签名一致
- 如果子类只实现了
load但没实现validate,实例化时依然报错 - 想允许部分方法有默认实现?直接去掉对应方法上的
@abstractmethod即可
子类忘记实现时,错误发生在哪一刻
不是定义子类时出错,也不是导入时出错,而是在你第一次执行 MyProcessor() 这种实例化操作时才触发。
这意味着:单元测试里如果不 new 一下子类,就发现不了遗漏;CI 流程中若没跑实例化路径,也会漏检。
- 静态检查工具(如 mypy)无法识别
@abstractmethod是否被满足,它只看类型签名 - IDE(如 PyCharm)通常能标出未实现的抽象方法,但属于提示,非强制
- 如果子类里写了
def validate(self, data): ...但拼错了名字(比如写成valiate),照样报错——名称必须完全一致
和 NotImplementedError 抛异常方式比有什么区别
手动在方法里写 raise NotImplementedError 是运行到那行才崩;@abstractmethod 是类加载完成、准备创建实例前就校验完毕——早了至少一个执行层级。
更关键的是语义不同:NotImplementedError 像是“我懒得写”,而 @abstractmethod 是“你必须写”,后者能参与 IDE 自动补全、文档生成、类型系统协作。
- 多重继承下,多个抽象基类的抽象方法都会被检查,缺一不可
- 如果子类想延迟实现(比如只在特定子子类中实现),可以用
__subclasses__()或注册机制绕过,但这属于高级用法,日常慎用 - 真正容易被忽略的是:抽象方法的
__doc__会被继承,所以写好父类 docstring,子类不用重复写说明


















