Python isinstance() 实例类型检测

说明

《Python 教程》持续更新中，提供建议、纠错、催更等加作者微信: gairuo123（备注：pandas教程）和关注公众号「盖若」ID: gairuo。跟作者学习，请进入 Python学习课程。欢迎关注作者出版的书籍：《深入浅出Pandas》和《Python之光》。

Python 的内置函数 isinstance() 用来判断一个对象是否是一个已知的类型，或者说检测对象是不是这个类型的实例、这个类的实例。如果要判断两个类型是否相同推荐使用 isinstance()。

numbers = [1, 2, 3, 4, 2, 5]

# 检查 numbers 是否为列表的实例
isinstance(numbers, list)
# True

语法

语法为：

isinstance(obj, class_or_tuple, /)

其中：

object：要检测判断的对象
class_or_tuple：被检测的类，支持：
- class
- type
- class 组成的元组
- types 模块中定义的 type
- union 类型

布尔值：返回对象是类的实例还是其子类的实例。

功能说明：

如果 object 参数是 class_or_tuple 参数的实例，或其（直接、间接或抽象基类）子类的实例，则返回 True。
如果 object 不是给定类型的对象，则总是返回 False。
如果 class_or_tuple 是类型对象的元组（或由该类元组递归生成）或多个类型的 union 类型，那么当 object 是其中任一类型的实例时就会返回 True。
如果 class_or_tuple 不是某个类型或类型元组，将会触发 TypeError 异常。
注：在 3.10 版本开始，class_or_tuple 可以是一个 union 类型。

如果 class_or_tuple 是元组那么以下相同：

isinstance(x, (A, B, ...))
# 同上
isinstance(x, A) or isinstance(x, B) or ...

示例

内置类型

a = 2

isinstance(a,int)
# True
isinstance(a,str)
# False
isinstance(a,(str,int,list)) # 是否其中一个
isinstance(a, str | int | list)
# True

types 模块

import types

isinstance(None, types.NoneType)
# True

isinstance(print, types.BuiltinFunctionType)
# True

自定义类

class Foo:
  a = 5

foo = Foo()

isinstance(foo, Foo) # True
isinstance(foo, (list, tuple)) # False
isinstance(foo, (list, tuple, Foo)) # True

和type()的区别

区别总结为：

type() 不会认为子类是一种父类类型，不考虑继承关系
isinstance() 会认为子类是一种父类类型，考虑继承关系

关于 isinstance() 与 type() 的区别可以看以下示例：

class A:
    pass

class B(A):
    pass

isinstance(A(), A)    # True
type(A()) == A        # True
isinstance(B(), A)    # True
type(B()) == A        # False

有人也用 type(variable) == str 这种方式判断某个对象的类型，虽然此方法是可行的，但不提倡。

参考

https://docs.python.org/3/library/functions.html#isinstance
https://www.programiz.com/python-programming/methods/built-in/isinstance
https://zhuanlan.zhihu.com/p/445657663