c++如何使用cxx库安全地调用Rust代码_c++与Rust互操作最佳实践【跨语言】-C++-PHP中文网

c++如何使用cxx库安全地调用Rust代码_c++与Rust互操作最佳实践【跨语言】

php中文网

发布： 2025-12-13 17:15:24

原创

961人浏览过

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

c++如何使用cxx库安全地调用rust代码_c++与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 边界收敛到一个小类里。

捏Ta

捏Ta 是一个专注于角色故事智能创作的AI漫画生成平台

322

查看详情

立即学习“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 头文件与库