答案:C++通过C ABI调用Rust函数需在Rust中使用#[no_mangle]和extern "C"导出函数,编译为动态库,C++中声明对应函数并链接调用,传递基础类型或#[repr(C)]标记的结构体,避免复杂类型。

要在C++中调用Rust编写的函数,核心方法是通过C语言的ABI(应用二进制接口)进行互操作。Rust支持生成与C兼容的函数接口,而C++可以直接调用C风格的函数。整个过程包括:在Rust中编写函数并导出为C ABI,编译为静态或动态库,然后在C++项目中链接并调用。
1. Rust端:导出C兼容函数
使用#[no_mangle]和extern "C"让Rust函数暴露给外部语言。
例如,创建一个Rust库,实现一个简单的加法函数:
// src/lib.rs
#[no_mangle]
pub extern "C" fn add(a: i32, b: i32) -> i32 {
a + b
}
这里的关键点:
立即学习“C++免费学习笔记(深入)”;
- extern "C":指定函数使用C调用约定
- #[no_mangle]:防止Rust编译器重命名函数名,确保符号可被C/C++识别
- 参数和返回值使用基础类型(如i32、f64),避免Rust特有类型(如String、Vec)
2. 编译Rust为静态/动态库
修改Cargo.toml,设置crate类型为cdylib或staticlib:
[lib] name = "rust_lib" # 生成动态库(推荐用于跨语言) crate-type = ["cdylib"]
执行编译:
cargo build --release
输出文件通常位于target/release/目录下:
- Linux:librust_lib.so
- macOS:librust_lib.dylib
- Windows:rust_lib.dll
3. C++端:声明并调用Rust函数
在C++代码中,用extern "C"声明函数原型,避免C++名称修饰问题。
// main.cpp #include// 声明Rust函数 extern "C" { int32_t add(int32_t a, int32_t b); }
int main() { int result = add(3, 4); std::cout << "Result: " << result << std::endl; return 0; }
4. 链接Rust库到C++程序
编译C++代码时,链接Rust生成的库。
例如,在Linux上:
g++ main.cpp -L./target/release -lrust_lib -o test_cpp export LD_LIBRARY_PATH=./target/release:$LD_LIBRARY_PATH ./test_cpp
注意:
- -L 指定库路径
- -l 指定库名(去掉前缀lib和后缀)
- 确保运行时能加载动态库(设置LD_LIBRARY_PATH或复制到系统路径)
复杂数据类型的处理
传递结构体或字符串需要额外注意内存布局和生命周期。
例如,Rust中定义并导出结构体:
#[repr(C)]
pub struct Point {
pub x: f64,
pub y: f64,
}
[no_mangle]
pub extern "C" fn distance(p1: Point, p2: Point) -> f64 {
((p1.x - p2.x).powi(2) + (p1.y - p2.y).powi(2)).sqrt()
}
C++中对应声明:
extern "C" {
double distance(Point p1, Point p2);
}
struct Point {
double x, y;
};
关键点:
- 使用#[repr(C)]确保结构体内存布局与C兼容
- 避免在跨语言边界传递所有权复杂的类型(如String),可改用const char* + 长度方式
基本上就这些。只要遵循C ABI规范,C++调用Rust并不复杂,但需小心类型匹配和内存管理。调试时可用nm或objdump检查Rust生成的符号是否正确导出。










