isinstance支持元组类型、抽象基类、联合类型(python 3.10+)及自定义__instancecheck__,可灵活实现协议判断与动态类型检查。

isinstance 不只是用来判断“是不是某个类”,它支持元组、抽象基类、联合类型(Python 3.10+),还能配合自定义 __instancecheck__ 实现灵活的类型逻辑。
传入类型参数可以是元组,一次检查多种可能
常见写法是 isinstance(obj, str),但更实用的是用元组批量匹配:
-
isinstance(x, (int, float))判断是否为数值类型(比type(x) in (int, float)更安全) -
isinstance(data, (list, tuple, set, frozenset))快速识别可迭代但非字符串的序列容器 - 元组中可混用具体类与抽象基类,例如
isinstance(f, (io.TextIOBase, io.BufferedIOBase))
配合 abc 模块做协议式判断,不依赖继承关系
用 collections.abc.Iterable、collections.abc.Mapping 等抽象基类,能识别实现了对应协议的对象,哪怕没显式继承:
-
isinstance([1,2], collections.abc.Iterable)→True - 自定义类只要实现
__iter__,即使没继承Iterable,也会被识别为Iterable - 比
hasattr(obj, '__iter__')更严谨,避免误判(比如有__iter__但返回非迭代器)
Python 3.10+ 支持 Union 类型(| 语法),isinstance 可直接识别
PEP 604 引入的联合类型在运行时可通过 types.UnionType 被 isinstance 理解:
立即学习“Python免费学习笔记(深入)”;
-
isinstance(x, int | str)等价于isinstance(x, (int, str)) - 注意:仅限运行时使用;静态类型检查(如 mypy)和
typing.get_origin对|的处理另有规则 - 不能用于带参数的泛型联合,如
list[int] | dict[str, int]—— 此时需降级为元组写法
高级技巧:自定义类控制 isinstance 行为
通过实现 __instancecheck__ 方法(定义在类的元类中),可让 isinstance 按需返回结果:
- 适用于构建类型门面、兼容旧代码的伪类型、或基于属性/行为的动态判定
- 示例:定义一个
NumberLike类,对含__add__和__mul__的对象返回True - 注意:该方法只影响
isinstance(obj, YourClass),不影响issubclass或常规继承逻辑










