Rust 中 extern “C“ 关键字

Vallelonga2026-01-20 8:55

上一篇博文https://blog.csdn.net/Vallelonga/article/details/157130310 中介绍了 rust bindgen, 其中提到了 extern "C" 块这个名词，这里对这个名词做一个解释。

很容易混淆的是，extern "C" 关键字能被用到两个位置，起到不完全相同的作用。

extern "C" 块

extern "C" 块用于声明外部实现的 C 代码，在使用时大概长下面这个样子

rust 复制代码

// "进口"清单
extern "C" {
    // 我没有 printf 的代码，但我知道它在 C 库里
    fn printf(fmt: *const u8, ...) -> i32;
}

fn main() {
    unsafe {
        // Rust 调用 C
        printf(b"Hello from C!\0".as_ptr()); 
    }
}

extern "C" 块中尽是 Rust 函数声明，每个声明对应一个用 C 在外部实现的函数。extern "C" 块告诉编译器，这些函数是用 C 在外部实现的，调用他们时要考虑这一点，恰当的使用 C ABI.

rust 代码调用这些 ffi 函数时，由于 rust 编译器完全不知道函数的内部实现，所以必须用 unsafe 包装。

extern "C" 标签

extern "C" 标签用于声明一个 rust 实现的函数，这个函数要预备着被外部 C 代码调用，使用时长这样

rust 复制代码

// "出口"产品
// 我在这里写了具体的代码实现
#[no_mangle] // 别改名，不然 C 找不到我
pub extern "C" fn my_rust_function(a: i32, b: i32) -> i32 {
    // 这里的逻辑由 Rust 运行，但被 C 调用
    a + b
}

extern "C" 后面紧跟着一个标准的 Rust 函数，extern "C" 告诉编译器，后面这个函数在编译后要符合 C 的 ABI（因为可能有 C 代码要调用他）。

Rust 代码也可以调用这样的函数，Rust 编译器在处理对这样的函数的调用时，也会默默地使用 C ABI 来生成调用代码。

而且由于这是一个标准的 Rust 函数，所以除非他本身声明是 unsafe 的，否则 rust 代码在调用他时可以把他当作普通的 Rust 函数。