无法绑定含右值引用参数的C++类成员函数（pybind11）

嘿，我之前也碰到过一模一样的问题！pybind11对成员函数的右值引用参数处理确实有点“挑剔”，不过不用修改原C++库的源码，咱们有两种简单的方案能搞定。

先回顾下你的简化场景：

struct Foo {
    void print_ref(int &&v) const {
        // 原库的实现逻辑
    }
};

直接绑定&Foo::print_ref会失败，但参数相同的非成员函数却能正常工作，核心原因是pybind11对成员函数的参数适配逻辑和非成员函数略有差异，咱们需要手动帮它完成右值的转换。

方案一：写一个包装函数 #

咱们可以写一个非成员的包装函数，把成员函数的调用逻辑包起来，然后把这个包装函数绑定为类的成员方法：

#include <pybind11/pybind11.h>
#include <utility> // 用于std::move

namespace py = pybind11;

// 原库的Foo类（假设无法修改）
struct Foo {
    void print_ref(int &&v) const {
        std::cout << "Value: " << v << std::endl;
    }
};

// 包装函数：接收Foo实例和普通int参数，转成右值传给原成员函数
void foo_print_ref(const Foo& self, int v) {
    self.print_ref(std::move(v));
}

PYBIND11_MODULE(foo_bindings, m) {
    py::class_<Foo>(m, "Foo")
        .def("print_ref", &foo_print_ref); // 把包装函数绑定为类的方法
}

方案二：用Lambda表达式简化（更推荐） #

不想写额外的包装函数？直接在绑定的时候用lambda表达式处理参数转换就行，代码更紧凑：

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

namespace py = pybind11;

struct Foo {
    void print_ref(int &&v) const {
        std::cout << "Value: " << v << std::endl;
    }
};

PYBIND11_MODULE(foo_bindings, m) {
    py::class_<Foo>(m, "Foo")
        .def("print_ref", [](const Foo& self, int v) {
            self.print_ref(std::move(v));
        });
}

原理说明 #

Python里没有C的右值引用概念，当你在Python中调用foo.print_ref(42)时，传入的是一个普通的整数对象。咱们的包装逻辑会把这个整数转成C的右值引用，刚好匹配原成员函数的参数要求。

如果原函数的参数是自定义类型的右值引用（比如void bar(MyType &&val)），方案也是一样的——只需要把lambda里的int换成对应的自定义类型，用std::move传递即可。

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