推荐使用 C ABI + 手写 extern "C" 方式:Rust 用 #[no_mangle] + extern "C" 暴露纯函数,C++ 用 extern "C" 声明并链接静态/动态库,内存管理责任明确,配合 RAII 封装句柄,避免 STL/Rust 高级类型、跨语言异常及线程安全问题。

直接在 C++ 中调用 Rust 代码,不推荐直接使用 cxx 库——因为 cxx 是一个 Rust 主导的绑定生成器,它的设计目标是让 Rust 代码安全地调用 C++,而非反过来。它生成的 C++ 接口是“只读”且高度受限的(例如不支持裸指针、不支持自定义析构、不支持多线程回调),用于 C++ 主动调用 Rust 并不可靠,也违背其设计初衷。
真正安全的 C++ 调用 Rust 的方式:C ABI + 手写 extern "C"
最成熟、稳定、跨平台、可调试的方式,仍是基于标准 C ABI 的互操作:
- Rust 端用
#[no_mangle]+extern "C"暴露纯函数,参数/返回值仅限 C 兼容类型(i32,const char*,struct值传递等) - C++ 端用
extern "C"声明函数,直接链接 Rust 编译出的静态库(.a)或动态库(.so/.dll) - 所有内存管理责任明确:谁分配、谁释放;Rust 不暴露
Box/Vec给 C++,如需传字符串或数组,用const char*+size_t或手动管理生命周期
安全封装:用 RAII 包装 Rust 资源(C++ 侧)
若 Rust 返回了需要释放的句柄(如 uintptr_t 表示的内部指针),C++ 应用 RAII 封装:
class RustBuffer {
uintptr_t handle_ = 0;
public:
explicit RustBuffer(uintptr_t h) : handle_(h) {}
~RustBuffer() { if (handle_) rust_buffer_free(handle_); }
RustBuffer(const RustBuffer&) = delete;
RustBuffer& operator=(const RustBuffer&) = delete;
// 提供 data()/size() 等只读访问接口
};
这样能避免裸指针泄漏和重复释放,把不安全的 C 边界收敛到一个小类里。
立即学习“C++免费学习笔记(深入)”;
避免踩坑的关键细节
-
禁止传递 C++ STL 类型或 Rust 的
String/Vec:它们的内存布局和 ABI 不稳定 -
禁止跨语言抛异常:Rust panic 会终止 C++ 线程,C++ exception 进入 Rust 未定义行为;统一用返回码(
int)或错误指针(nullptr)表示失败 -
注意线程安全:Rust 的
Send/Sync不自动映射到 C++;若 Rust 函数被多线程调用,确保其内部加锁或标明unsafe并由 C++ 同步 -
构建集成:用 CMake 的
add_subdirectory或find_package引入 Rust 构建产物,或用cargo-c工具生成标准 C 头文件与库
什么时候可以考虑 cxx(谨慎)
仅当你的主程序是 Rust,而少量性能关键模块用 C++ 实现,并希望 Rust 安全调用它们时,cxx 才是正途。反过来强行用它让 C++ 去“调用 Rust 对象”,会导致:
- 生成大量模板膨胀的 C++ 代码,编译慢、调试难
- 无法控制 Rust 对象生命周期(
cxx::UniquePtr在 C++ 侧析构可能触发 panic) - 不支持 const 成员函数、重载、虚函数等常见 C++ 模式
基本上就这些。C ABI 虽然原始,但清晰、可控、零运行时开销,是跨语言互操作的基石。别为了“酷”放弃稳定性。











