如何通过Python的__instancecheck__自定义isinstance行为？-Python教程-PHP中文网

__instancecheck__ 必须定义在元类中而非普通类里，因为 isinstance() 的查找逻辑是先获取对象所属类的元类，再调用该元类的 __instancecheck__ 方法；若直接写在类体中则完全不生效。

如何通过python的__instancecheck__自定义isinstance行为？

为什么 `instancecheck` 不会在类定义里直接生效？

因为 __instancecheck__ 必须定义在**元类**中，而不是普通类里。Python 的 isinstance() 查找逻辑是：先检查对象的 __class__ 是否有对应的元类，再调用该元类的 __instancecheck__ 方法。如果你把它写在类体里，它根本不会被调用。

错误写法：class A: def __instancecheck__(self, inst): ... → 完全无效
正确路径：定义一个元类，重写它的 __instancecheck__，再让目标类使用这个元类
注意：元类必须继承 type，否则可能破坏类创建流程

怎么写一个可复用的元类来控制 `isinstance` 判断逻辑？

最常见需求是让某个类“假装”是另一个类型的实例（比如让 dict 实例通过 isinstance(obj, MyInterface)）。这时元类需捕获类型检查请求，并按自定义规则返回布尔值。

元类中 __instancecheck__ 的第一个参数是元类自身（即类对象），第二个是待检查的实例
不要在其中做耗时操作——isinstance 可能高频调用，影响性能
示例：让所有含 data 属性且为 dict 的对象被视为 DataContainer 实例

class DataContainerMeta(type):
    def __instancecheck__(cls, instance):
        return hasattr(instance, 'data') and isinstance(instance.data, dict)
<p>class DataContainer(metaclass=DataContainerMeta):
pass</p><p>obj = type('Fake', (), {'data': {}})()
print(isinstance(obj, DataContainer))  # True
</p>

`instancecheck` 和 `subclasscheck` 有什么区别？

__instancecheck__ 控制 isinstance(obj, Cls)，而 __subclasscheck__ 控制 issubclass(Sub, Cls)。两者常成对出现，但用途完全不同。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载