Linux系统中Rust与C++如何互操作

首页

编程语言

热心网友

转载

2026-04-24

在Linux系统中，Rust和C++如何互操作

在Linux开发领域，将Rust和C++这两种高性能语言结合起来，往往能发挥出“1+1>2”的效果。而实现这一点的关键，就是FFI（外部函数接口）。下面这张图直观地展示了互操作的核心流程，我们可以结合它来理解后续的步骤。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

Linux系统中Rust与C++如何互操作

接下来，我们分两个方向来拆解：如何让Rust调用C++，以及反过来，如何让C++调用Rust。

Rust调用C++函数

让Rust去调用C++的代码，其实是一个“三步走”的过程：先准备好C++库，然后在Rust里声明它，最后完成链接和运行。

编写C++代码并导出函数

这里有个关键点：C++编译器默认会对函数名进行“名称改编”，这会导致Rust找不到它。解决办法就是用extern "C"来告诉编译器：“这个函数请用C语言的规则来编译，保持名字不变。”这样，Rust才能通过名字正确识别它。
```
// example.cpp
#include 

extern "C" {
    void hello_from_cpp() {
        std::cout << "Hello from C++!" << std::endl;
    }
}
```
编译C++代码为静态库或动态库

C++代码不能直接给Rust用，需要先打包成库。你可以选择编译成静态库（.a文件）或动态库（.so文件）。静态库会直接嵌入最终的可执行文件，而动态库则在运行时加载，更灵活一些。
```
# 编译为目标文件
g++ -c example.cpp -o example.o

# 打包成静态库
ar rcs libexample.a example.o

# 或者，打包成动态库（注意-fPIC参数）
g++ -fPIC -c example.cpp -o example.o
g++ -shared -o libexample.so example.o
```
在Rust中使用extern块声明外部函数

现在轮到Rust这边了。我们需要用extern块来声明：“有一个外部的C函数叫hello_from_cpp。”同时，通过#[link]属性告诉Rust编译器链接哪个库。这里必须注意：所有FFI调用在Rust中都被视为“不安全”操作，因此必须放在unsafe块中。
```
// main.rs
extern crate libc;

#[link(name = "example")]
extern "C" {
    fn hello_from_cpp();
}

fn main() {
    unsafe {
        hello_from_cpp();
    }
}
```
运行Rust程序

最后一步就是编译和运行了。根据你使用的库类型，需要注意不同的路径设置：
- 静态库：相对简单，确保库文件在链接时能被找到即可。
- 动态库：除了编译时，在运行时系统也需要知道库的位置，这通常通过设置LD_LIBRARY_PATH环境变量来实现。
```
# 编译Rust程序
rustc main.rs

# 运行（假设是静态库，或动态库已在系统路径）
./main

# 如果动态库在当前目录，需要指定运行时路径
LD_LIBRARY_PATH=. ./main
```

C++调用Rust函数

反过来，让C++调用Rust函数，思路是类似的，但角色互换。核心同样是确保函数名在链接时清晰可见。

编写Rust代码并导出函数

在Rust这边，我们需要做两件事来“暴露”函数：第一，使用#[no_mangle]属性，防止编译器对函数名进行优化和改编；第二，用extern "C"指定使用C语言的调用约定。
```
// lib.rs
#[no_mangle]
pub extern "C" fn hello_from_rust() {
    println!("Hello from Rust!");
}
```
编译Rust代码为动态库

目前，C++调用Rust最方便的方式是通过动态库。使用Cargo可以轻松完成编译。
```
cargo build --release
```
编译完成后，生成的.so动态库文件通常位于target/release/目录下。
在C++中使用extern块声明外部函数

这和Rust调用C++时的声明几乎是对称的。在C++文件中，我们同样用extern "C"来声明一个来自外部的、使用C约定的函数。
```
// main.cpp
#include 

extern "C" {
    void hello_from_rust();
}

int main() {
    hello_from_rust();
    return 0;
}
```
链接Rust动态库并编译C++代码

这是最复杂的一步。你需要用g++编译C++代码，并明确链接上一步生成的Rust动态库，以及Rust运行时依赖的一些系统库。关键在于-L参数要指向你的Rust库路径，-l参数要指定库名（通常去掉lib前缀和.so后缀）。
```
g++ -o main main.cpp -L/path/to/rust/library -lrustc_driver -lrustc_interface -lrustc_codegen -lrustc_middle -lrustc_llvm -lrustc_serialize -lstdc++fs -lpthread -ldl
```
注意，这里链接的Rust库名（如rustc_driver）是示例，实际名称取决于你的项目。一个更简单的做法是直接链接由cargo生成的、以你项目命名的.so文件。
运行C++程序

和之前一样，如果使用了动态库，别忘了在运行时通过LD_LIBRARY_PATH告诉系统库在哪里。
```
LD_LIBRARY_PATH=. ./main
```