如何实现pybind11绑定结构体时无需导入第三方库即可访问成员？

通用解决方案 #

问题根源是第三方库的pybind11绑定类型未被Python解释器加载，导致访问MyStruct.member时无法完成类型转换。可通过以下两种方式解决：

1. 绑定代码中显式导入第三方库的Python模块 #

在你的绑定代码里添加模块导入逻辑，提前加载第三方库的绑定模块，让Python解释器注册对应类型转换器。示例代码：

struct MyStruct {
  ClassFromThirdParty member{};
};

// 提前加载第三方库的Python模块
py::module::import("ThirdPartyLibrary");

py::class_<MyStruct>(m, "MyStruct")
    .def_readwrite("member", &MyStruct::member);

用户导入你的模块时，第三方库模块会自动加载，无需手动导入。

2. 为第三方类型注册延迟加载转换器 #

若不想提前加载整个模块，可使用pybind11的py::type_caster机制，为ClassFromThirdParty注册延迟加载的类型转换器，首次访问该类型时再触发模块导入。示例代码：

#include <pybind11/pybind11.h>

namespace py = pybind11;

// 自定义类型转换器
namespace pybind11 { namespace detail {
    template <> struct type_caster<ClassFromThirdParty> {
        PYBIND11_TYPE_CASTER(ClassFromThirdParty, _("ThirdPartyLibrary.ClassFromThirdParty"));

        // 从Python转换到C++，复用原有转换器
        bool load(py::handle src, bool) {
            py::module::import("ThirdPartyLibrary");
            return type_caster_base<ClassFromThirdParty>::load(src, false);
        }

        // 从C++转换到Python，复用原有转换器
        static py::handle cast(const ClassFromThirdParty& src, return_value_policy policy, py::handle parent) {
            py::module::import("ThirdPartyLibrary");
            return type_caster_base<ClassFromThirdParty>::cast(src, policy, parent);
        }
    };
}} // namespace pybind11::detail

struct MyStruct {
  ClassFromThirdParty member{};
};

py::class_<MyStruct>(m, "MyStruct")
    .def_readwrite("member", &MyStruct::member);

针对Drake库的专属方案 #

如果依赖的是Drake库，可利用其绑定模块的延迟导入机制，提前导入对应子模块确保类型转换器注册：

#include "drake/bindings/pydrake/pydrake_pybind.h"
#include "drake/math/rotation_matrix.h" // 示例类型

struct MyStruct {
  drake::math::RotationMatrix<double> member{};
};

PYBIND11_MODULE(my_bindings, m) {
    // 提前导入drake的math模块
    py::module::import("pydrake.math");

    py::class_<MyStruct>(m, "MyStruct")
        .def_readwrite("member", &MyStruct::member);
}

导入你的模块时，Drake的对应子模块会自动加载，用户无需手动导入pydrake即可正常访问成员。

内容的提问来源于stack exchange，提问作者Alexander Soare