pybind11导出C++类时如何重写__instancecheck__方法

使用pybind11完全可以实现该需求。

你之前触发PyType_Ready failed (AttributeError: mro)!报错的根因和推测一致：你绑定的PippoMeta默认继承自Python内置object，但Python语法要求所有自定义元类必须继承自内置type类型，非type子类的类型无法作为元类使用，CPython在构建类的方法解析顺序阶段就会抛出错误。

实现步骤 #

• 绑定自定义元类时，显式指定其基类为Python内置type，元类本身不需要额外C++逻辑，空结构体即可作为载体。
• 为元类绑定__instancecheck__方法时注意参数规则：第一个参数是元类创建的类对象本身，第二个参数是待检查的实例对象。
• 绑定目标C++类时，通过py::metaclass()接口指定使用自定义元类。

修正后的代码 #

#include <pybind11/pybind11.h>
namespace py = pybind11;

struct Pluto {};
struct Pippo {};
// 元类无需额外C++字段或方法，空结构体即可
struct PippoMeta {};

PYBIND11_MODULE(my_module, m) {
    // 核心：绑定元类时显式声明继承自py::type，对应Python侧的type类型
    py::class_<PippoMeta> pimeta(m, "PippoMeta", py::base<py::type>());
    
    py::class_<Pluto> plclass(m, "Pluto");
    // 为Pippo类指定自定义元类
    py::class_<Pippo> piclass(m, "Pippo", py::metaclass(pimeta));

    plclass.def(py::init<>());
    piclass.def(py::init<>());
    
    // 实现自定义实例检查逻辑
    pimeta.def("__instancecheck__", [](py::object, const Pluto&) {
        py::print("Custom __instancecheck__ called");
        return true;
    });
}

验证方式 #

编译为Python模块后，执行以下测试代码即可看到自定义逻辑生效：

from my_module import Pluto, Pippo
pluto_inst = Pluto()
print(isinstance(pluto_inst, Pippo))

运行输出：

Custom __instancecheck__ called
True

补充说明 #

• 如果不需要在C++侧维护元类的状态，甚至可以省略PippoMeta空结构体，直接动态创建继承自type的Python类作为元类，但空结构体的写法和pybind11常规绑定逻辑一致，可读性更高。
• __instancecheck__是元类层面的特殊方法，直接绑定到普通C++类上不会生效，Python只会在类对应的元类上查找该方法。

内容的提问来源于stack exchange，提问作者Nicola Gigante