如何判断一个对象是否实现了某个抽象基类(ABC)

最推荐用 isinstance(obj, ABC) 检查类型,因其支持虚拟继承和协议实现;type() 或 issubclass(type(), ABC) 仅检测显式继承,会漏判;hasattr 仅查属性存在性,不可替代 isinstance。

直接用 isinstance() 检查即可,这是最标准、最推荐的方式。

使用 isinstance(obj, ABC)

Python 的抽象基类(如 collections.abc.Iterablecollections.abc.Mapping)支持“虚拟继承”——即使类没有显式继承该 ABC,只要它注册了或实现了约定的接口(比如有 __iter__),isinstance() 就会返回 True

  • ✅ 正确示例:isinstance([1,2,3], collections.abc.Iterable)True
  • ✅ 自定义类即使没写 class MyList(Iterable),只要实现了 __iter__,再调用 MyList.register(Iterable) 或直接用 @abstractmethod 配合 ABC 定义,也能被识别
  • ⚠️ 注意:不能用 type(obj) is ABCissubclass(type(obj), ABC),这只能检测显式继承,会漏掉虚拟子类和鸭子类型兼容对象

检查是否“注册”为虚拟子类

有些类通过 ABC.register(ConcreteClass) 声明自己是某 ABC 的子类,但并未实现所有抽象方法(属于“不完全适配”,仅用于类型提示或轻量判断)。

  • 可用 issubclass(ConcreteClass, ABC) 查看是否注册成功
  • 但注意:注册后 isinstance(obj, ABC) 仍可能返回 False,如果该实例所属类未真正满足协议(比如没实现必要方法),具体取决于 ABC 的实现逻辑;多数标准 ABC(如 Iterable)在注册后会放宽运行时检查

查看抽象方法是否被实现(进阶调试)

isinstance() 返回 False 但你预期为 True 时,可手动验证关键方法是否存在且可调用:

  • 查方法:用 hasattr(obj, '__iter__')callable(getattr(obj, '__iter__', None))
  • 参考 ABC 的 __abstractmethods__ 属性(如 collections.abc.Iterable.__abstractmethods__ 返回 frozenset({'__iter__'})),确认要实现哪些方法
  • 注意:某些 ABC(如 Sequence)还依赖其他方法(__len____getitem__)共同生效,缺一不可

避免用 hasattr 单独替代 isinstance

hasattr 只检查属性存在性,不保证语义正确或可安全调用:

  • hasattr(obj, '__iter__')True,但该属性可能

    None 或抛异常,不能等价于“可迭代”
  • isinstance(obj, Iterable) 内部已综合判断可调用性、返回值类型等,更可靠
  • 仅在调试或元编程中临时用 hasattr 辅助定位问题,不要用于生产环境的类型判断逻辑