子类实例化时抛出NotImplementedError是因为父类用raise NotImplementedError手动模拟抽象方法而子类未重写；这是“土法抽象”，仅在调用时触发，非abc.ABC的正式机制。
为什么子类实例化时抛出 NotImplementedError
因为父类用 raise NotImplementedError 手动模拟抽象方法，而子类没重写对应方法——Python 不会自动检查，只有运行到那行才炸。这不是 abc.ABC 的正式抽象机制，属于“土法抽象”，排查时容易误以为是语法错误或继承失效。
- 常见于第三方库（如某些爬虫框架、旧版机器学习接口）用这种方式强制子类实现逻辑
- 和
abc.abstractmethod行为不同：后者在子类未实现时，实例化前就报TypeError；前者静默通过，直到调用才触发 - 错误堆栈里通常能看到你调用的某个方法名（比如
parse()或transform()），直接定位到抛出NotImplementedError的那一行
怎么快速定位该重写哪个方法
别猜，看父类源码里所有 raise NotImplementedError 出现的位置。重点盯紧 def 开头、紧接着就是 raise 的函数。
- 用 IDE 的 “Find in Files” 搜
raise NotImplementedError，范围限定在父类所在文件 - 注意同名但不同参数的方法：比如父类有
def process(self, data)抛错，子类写了def process(self)就不算重写，仍会触发异常 - 有些父类会在 docstring 里写 “Subclasses must implement …”，比代码更直白，别跳过注释
重写时要注意参数签名和返回值约定
不是只要函数名对就行，参数个数、顺序、默认值都得匹配，否则可能在下游调用时报错或逻辑错乱。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 复制父类方法头（包括
*args,**kwargs）再改内容，避免漏掉可选参数 - 如果父类方法有类型提示（如
def load(self, path: str) -> dict:），建议子类也保留，有助于静态检查和协作理解 - 返回值类型最好一致：父类注释说返回
list，你就别返回generator，除非文档明确允许 - 示例：父类有
def validate(self, payload: dict) -> bool:，子类必须写def validate(self, payload):，不能少参数，也不能改成def validate(self, *args)后再解包
想提前发现遗漏？加一层运行时检查
如果你维护的是基类，或者能修改父类，把土法抽象升级为标准抽象更可靠；如果只能改子类，可以在子类 __init__ 里主动探测关键方法是否被真正覆盖。
立即学习“Python免费学习笔记（深入）”；
- 检查方式：
getattr(self, 'method_name').__func__ is not ParentClass.method_name，确认不是继承来的原版 - 更简单粗暴的调试技巧：在父类抛错前加
print(f"Warning: {self.__class__.__name__} did not override {inspect.stack()[1].function}") - 不推荐在生产环境用
try/except NotImplementedError包裹调用——掩盖问题，不是修复问题
真正麻烦的往往不是漏写一个方法，而是父类有多个 NotImplementedError 分散在不同生命周期钩子中（比如 setup()、run()、teardown()），得按实际执行路径逐个补全。
