如何在Rust中创建C++对象并持有指向该对象的指针?
实现Rust持有C++对象指针的完整方案
核心逻辑很直接:C++本身不存在稳定通用的C ABI,因此无法直接将C类的构造、析构逻辑直接暴露给Rust。只需要在C侧加一层纯C ABI的封装层,把创建C++对象的逻辑收在这层封装里,再把返回的裸指针传给Rust,就完全匹配之前提到的跨语言指针约定(即跨边界传递的对象句柄本质是裸指针)。
具体操作步骤
- C++侧封装纯C ABI的对象管理接口
所有需要跨边界暴露的C类逻辑,都要封装为带extern "C"标记的函数,由C原生代码完成对象的构造、销毁、方法调用,对外只暴露不透明的裸指针:// 目标C++类 class TargetCppClass { public: TargetCppClass(int init_value) { /* 原生C++构造逻辑 */ } ~TargetCppClass() { /* 原生C++析构逻辑 */ } void process() { /* 类成员方法逻辑 */ } }; // 给Rust调用的纯C接口层 extern "C" { // 堆上创建C++对象,返回裸指针 TargetCppClass* create_cpp_obj(int init_value) { return new TargetCppClass(init_value); } // 销毁对应C++对象 void destroy_cpp_obj(TargetCppClass* obj_ptr) { delete obj_ptr; } // 调用对象成员方法 void call_cpp_process(TargetCppClass* obj_ptr) { obj_ptr->process(); } } - 用bindgen生成Rust侧的绑定代码
bindgen会自动识别上面这层extern "C"接口的签名,把TargetCppClass*直接映射为Rust可识别的*mut TargetCppClass裸指针类型,Rust拿到这个指针后,就相当于获得了指向对应C++对象的有效句柄。 - Rust侧做安全封装
拿到的裸指针属于unsafe范畴,需要把它包装成符合Rust生命周期规则的智能句柄,把对象析构逻辑和Droptrait绑定,避免内存泄漏:// 以下类型与签名均为bindgen自动生成 extern "C" { fn create_cpp_obj(init_value: i32) -> *mut TargetCppClass; fn destroy_cpp_obj(obj_ptr: *mut TargetCppClass); fn call_cpp_process(obj_ptr: *mut TargetCppClass); } // 包装成安全的Rust类型 pub struct CppObjHandle { inner: *mut TargetCppClass } impl CppObjHandle { pub fn new(init_value: i32) -> Self { let ptr = unsafe { create_cpp_obj(init_value) }; assert!(!ptr.is_null(), "C++对象创建失败"); Self { inner: ptr } } pub fn process(&self) { unsafe { call_cpp_process(self.inner) } } } // 作用域退出时自动调用C++侧的析构接口 impl Drop for CppObjHandle { fn drop(&mut self) { unsafe { destroy_cpp_obj(self.inner) } } }
必须注意的边界规则
- 绝对不要在Rust侧直接实例化C类。哪怕bindgen导出了类的结构定义,C类的内存布局、vtable偏移、构造函数的栈调整逻辑都没有固定跨语言约定,直接在Rust侧构造对象会直接触发内存未定义行为。
- 内存的申请和释放必须配对。Rust侧绝对不能用自身的全局分配器释放C侧通过
new申请的堆内存,必须调用C暴露的销毁接口触发原生析构和delete流程,否则会直接损坏堆结构。 - C异常不能跨ABI边界。所有
extern "C"接口内部必须catch住所有C抛出的异常,转成错误码返回给Rust,否则异常穿过C ABI边界会直接导致程序崩溃。 - 裸指针转引用必须谨慎。只有能确保指针的生命周期、可变性完全符合Rust借用规则时,才能把
*mut/*const裸指针转成安全引用,否则随意转换会触发数据竞争。
内容的提问来源于stack exchange,提问作者Poperton
相关产品推荐
相关产品推荐

