如何使用pybind11向Python暴露按引用修改数据的C++函数？

同步失败是两个语言的类型语义差异+默认绑定逻辑共同导致的：

• Python原生str是不可变对象，解释器层面禁止原地修改内存内容，不存在C/C++里char*原地改值的语义基础
• pybind11默认处理char*类型入参时，会将传入的Python字符串拷贝到独立的临时C风格字符数组中，C++代码修改的是这份临时内存，函数返回后临时内存直接释放，修改结果完全不会回写到Python侧原对象
• 测试代码里自定义类的string属性本质还是原生不可变str，传入后依然走临时拷贝逻辑，不可能同步修改结果

推荐优先选第一种方案，完全符合Python生态的使用习惯，没有内存安全风险。

方案1：绑定层封装，返回修改后的字符串（最推荐） #

Python生态没有“传字符串引用原地修改”的惯例，常规做法是传入原始值，返回修改后的结果。不需要改动原有C++业务代码，只需要修改pybind11绑定逻辑加一层包装即可：

PYBIND11_MODULE(copylib, m)
{
    m.doc() = "test modifying string passed by reference"; 
    py::class_<Copy_String>(m,"Copy_String")
        .def_static("ModifyString", [](std::string input) {
            // 预分配足够的缓冲区空间，避免strcpy溢出
            input.resize(256);
            // 调用原有C++函数，直接操作string的内部可写内存
            int ret = Copy_String::ModifyString(input.data());
            // 截断到字符串实际长度，清除预分配的冗余空间
            input.resize(strlen(input.data()));
            // 同时返回函数状态码和修改后的字符串
            return py::make_tuple(ret, input);
        }, "Modify String passed by reference");
}

Python侧调用不需要做特殊适配：

import copylib as cp

ret_code, modified_str = cp.Copy_String.ModifyString("ABC")
print(modified_str)  # 输出：Data to be copied

方案2：传可变字节缓冲区，实现原地修改 #

如果必须保留C++风格的“传引用原地修改”逻辑，Python侧不能传入不可变的str，必须传入可变的字节缓冲区（比如bytearray），绑定层通过pybind11的buffer接口直接操作缓冲区内存：
首先修改绑定代码：

PYBIND11_MODULE(copylib, m)
{
    m.doc() = "test modifying string passed by reference"; 
    py::class_<Copy_String>(m,"Copy_String")
        .def_static("ModifyString", [](py::buffer rxBuf) {
            // 申请缓冲区的可写访问权限
            py::buffer_info buf_info = rxBuf.request(true);
            // 基础校验：缓冲区必须是单字节类型，且空间足够写入目标字符串
            if (buf_info.itemsize != 1) {
                throw std::runtime_error("传入的缓冲区必须是字节类型");
            }
            // "Data to be copied"含末尾结束符共17字节，提前做长度校验避免溢出
            if (buf_info.size < 17) {
                throw std::runtime_error("缓冲区长度不足，至少需要17字节");
            }
            // 拿到缓冲区原始指针传给原有C++函数
            return Copy_String::ModifyString(static_cast<char*>(buf_info.ptr));
        }, "Modify String passed by reference");
}

Python侧调用时需要提前初始化足够长度的可变bytearray：

import copylib as cp

# 初始化可变字节数组，初始内容为ABC，额外预留足够空间
rx_buf = bytearray(b"ABC" + b"\x00" * 20)
print("修改前：", rx_buf.split(b"\x00", 1)[0].decode())
cp.Copy_String.ModifyString(rx_buf)
# 截取到字符串结束符位置，转成普通Python字符串
modified_str = rx_buf.split(b"\x00", 1)[0].decode()
print("修改后：", modified_str)  # 输出：Data to be copied

不要尝试直接修改传入的Python原生str内存，这类操作属于Python解释器层面的未定义行为，会破坏字符串驻留机制，大概率导致解释器崩溃或者出现诡异的逻辑bug。
不推荐直接用ctypes裸传char*，pybind11的buffer接口已经内置了对象生命周期、可写权限、类型校验逻辑，比裸传指针的内存安全性高很多。

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