NotImplementedError是运行时错误而非语法强制，子类可实例化但调用未实现方法时立即报错；适合轻量场景，不依赖abc模块，但无静态检查支持，调试时应放在顶层接口方法中。
NotImplementedError 不是语法强制，而是运行时提醒——它不会阻止子类实例化，但一调用未实现的方法就立刻报错。
为什么不用抽象方法（@abstractmethod）而选 NotImplementedError
当你不想引入 abc 模块、或需要更灵活的控制时机（比如只在某些条件下才要求实现），NotImplementedError 就是轻量级替代方案。它不依赖元类机制，也不影响类的继承链检查，适合快速原型或内部基类设计。
- 子类可以正常实例化，
__init__不受影响 - 错误发生在真正调用该方法时，而非创建对象时
- 异常信息可自定义，比如写明「请在子类中重写
process()以支持 JSON 导出」 - 和
@abstractmethod不兼容：如果一个类同时用了@abstractmethod和手动raise NotImplementedError，前者已足够，后者冗余
常见误用：把 NotImplementedError 当成接口声明
它不是类型系统的一部分，静态检查工具（如 mypy）默认不识别它作为“必须实现”的信号。如果你依赖 IDE 自动提示或类型检查来发现遗漏，仅靠 NotImplementedError 是不够的。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- mypy 默认认为
raise NotImplementedError是合法的函数体，不会报错 - 要获得检查能力，得配合
@abstractmethod+ABC，或用类型注解加assert False等 hack（不推荐） - PyTorch 的
nn.Module.forward就是典型例子：父类直接raise NotImplementedError，子类忘了重写就会在训练/推理时崩，而不是模型构建阶段
在 __init__ 或其他方法里提前校验是否实现
如果希望更早暴露问题（比如初始化后立刻检查关键方法是否存在），可以用 hasattr + callable 主动判断：
def __init__(self, x, y):
self.x = x
self.y = y
if not hasattr(self, 'run') or not callable(getattr(self, 'run')):
raise TypeError(f'{self.__class__.__name__} must implement a callable "run" method')
- 这种方式比等运行到
run()才报错更利于调试 - 注意：不能在
__init__里直接调用self.run()，否则会无限递归（如果子类没重写，又回到父类的raise） - 适用于关键路径必须存在某行为的场景，比如任务调度器要求每个任务都有
execute()
真正容易被忽略的是：NotImplementedError 的抛出位置决定了排查成本。放在深层调用链末端（比如某个辅助函数里），堆栈会很长；放在顶层接口方法里，错误一眼可见。别把它藏得太深。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
