You need to enable JavaScript to run this app. 如何在Rust中创建C++对象并持有指向该对象的指针?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Rust中创建C++对象并持有指向该对象的指针?

实现Rust持有C++对象指针的完整方案

核心逻辑很直接:C++本身不存在稳定通用的C ABI,因此无法直接将C类的构造、析构逻辑直接暴露给Rust。只需要在C侧加一层纯C ABI的封装层,把创建C++对象的逻辑收在这层封装里,再把返回的裸指针传给Rust,就完全匹配之前提到的跨语言指针约定(即跨边界传递的对象句柄本质是裸指针)。

具体操作步骤

  1. 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();
        }
    }
    
  2. 用bindgen生成Rust侧的绑定代码
    bindgen会自动识别上面这层extern "C"接口的签名,把TargetCppClass*直接映射为Rust可识别的*mut TargetCppClass裸指针类型,Rust拿到这个指针后,就相当于获得了指向对应C++对象的有效句柄。
  3. Rust侧做安全封装
    拿到的裸指针属于unsafe范畴,需要把它包装成符合Rust生命周期规则的智能句柄,把对象析构逻辑和Drop trait绑定,避免内存泄漏:
    // 以下类型与签名均为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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 21:24:10