如何通过Python修改pybind11暴露的Big类中Smol实例属性

问题根源 #

默认情况下，通过b.contents[0]访问Big容器内的Smol对象时，pybind11会返回对象副本，修改副本的属性自然不会影响容器内的原始实例。我们需要让Python端直接操作Big内部的Smol实例，同时保证Big内的实例与外部Smol实例完全独立（满足不用指针向量的要求）。

解决方案 #

核心思路是让pybind11返回Big内部Smol对象的非const引用，而非副本，同时通过reference_internal策略绑定引用生命周期到Big实例，避免悬空引用。

1. C++类定义 #

保持Big容器存储Smol值对象，确保外部实例与内部实例相互独立：

#include <vector>
#include <string>

class Smol {
public:
    std::string name;
    Smol(std::string n) : name(std::move(n)) {}
};

class Big {
public:
    std::vector<Smol> contents;
    Big() {
        contents.emplace_back("original");
    }
};

2. pybind11绑定代码 #

自定义容器访问逻辑，返回内部Smol对象的引用，并指定生命周期策略：

#include <pybind11/pybind11.h>
#include <pybind11/stl.h>

namespace py = pybind11;

PYBIND11_MODULE(example, m) {
    // 绑定Smol类，开放name属性的读写权限
    py::class_<Smol>(m, "Smol")
        .def(py::init<std::string>())
        .def_readwrite("name", &Smol::name);

    // 绑定Big类，自定义contents的访问逻辑
    py::class_<Big>(m, "Big")
        .def(py::init<>())
        .def_property_readonly("contents", [](Big& self) -> py::list {
            py::list lst;
            for (auto& smol : self.contents) {
                // 将内部Smol的引用添加到列表，绑定生命周期到Big实例
                lst.append(py::cast(&smol, py::return_value_policy::reference_internal));
            }
            return lst;
        });
}

3. Python端测试 #

此时修改Big内的Smol属性会直接生效，且外部实例与内部实例互不影响：

import example

# 测试修改Big内的Smol属性
b = example.Big()
print(b.contents[0].name)  # 输出: original
b.contents[0].name = "lorem"
print(b.contents[0].name)  # 输出: lorem

# 测试外部实例不影响内部
external_smol = example.Smol("external")
b.contents[0].name = "modified"
print(external_smol.name)  # 输出: external

关键说明 #

• py::return_value_policy::reference_internal：告诉pybind11返回的引用属于Big实例内部，其生命周期与Big绑定，Big实例存活时引用有效，避免悬空引用风险。
• Big容器存储的是Smol值对象，外部创建的Smol实例与内部实例完全独立，修改外部实例不会影响Big内的对象，满足需求。

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