如何用Rust创建兼容C ABI的动态库？最优方案问询

核心思路是把unsafe代码严格限制在最外层的C/Rust适配层，上层业务逻辑完全用安全Rust编写，彻底解耦C ABI细节和Rust核心逻辑。这样既满足C程序的插件要求，又能最大化利用Rust的内存安全特性。

1. 手动定义最小化C ABI绑定 #

不用bindgen全量生成头文件内容，只手动编写插件系统必需的类型和函数签名，减少冗余的unsafe代码：

use libc::{c_char, c_int, size_t};

// 严格对应C端的plugin_t结构体布局，#[repr(C)]保证内存布局兼容
#[repr(C)]
pub struct plugin_t {
    pub id: *const c_char,
    pub process: extern "C" fn(data: *const u8, len: size_t) -> c_int,
}

2. 实现纯安全的Rust核心逻辑 #

把所有业务逻辑放在这一层，完全不涉及指针、unsafe操作，只处理Rust原生的安全类型：

// 纯安全代码，专注业务逻辑
fn rust_process(data: &[u8]) -> Result<(), String> {
    if data.is_empty() {
        return Err("输入数据不能为空".to_string());
    }
    // 这里写你的核心业务处理，比如解析数据、调用Rust库等
    println!("处理数据长度：{}", data.len());
    Ok(())
}

3. 编写最小化unsafe适配层 #

这层是唯一的unsafe代码区域，只做类型转换、边界检查，把C的调用转成安全Rust的调用，再把结果转回C的格式：

// C调用入口，仅做适配，逻辑极简
extern "C" fn c_process(data: *const u8, len: size_t) -> c_int {
    // 检查空指针，避免未定义行为
    let data_slice = unsafe {
        if data.is_null() {
            eprintln!("错误：传入空指针");
            return -1;
        }
        // 确认len合法（如果C端可能传非法长度，可额外加限制）
        std::slice::from_raw_parts(data, len)
    };

    // 调用安全核心逻辑，转换返回值为C的整数码
    match rust_process(data_slice) {
        Ok(_) => 0, // C端约定0表示成功
        Err(msg) => {
            eprintln!("插件错误：{}", msg);
            -1 // 非0表示失败
        }
    }
}

// 导出C端需要的全局插件结构体
#[no_mangle] // 禁止Rust编译器混淆符号名
#[used] // 确保编译器不会优化掉这个全局变量
pub static PLUGIN: plugin_t = plugin_t {
    id: b"rust-demo-plugin\0".as_ptr() as *const c_char, // 静态C字符串，生命周期与库一致
    process: c_process,
};

4. 编译配置 #

在Cargo.toml里指定编译为C兼容的动态库：

[package]
name = "rust-plugin"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib"] # 生成C ABI兼容的动态库

[dependencies]
libc = "0.2" # 提供C标准库类型的绑定

关键注意事项 #

• 字符串安全：C端的const char*必须用静态字节数组（带\0结尾），保证生命周期与动态库一致，避免悬空指针。如果需要动态生成字符串，需用libc::malloc分配，并在C端约定释放逻辑。
• 边界检查：适配层必须严格检查空指针、非法长度等，避免触发未定义行为。
• 错误处理：根据C程序的约定转换错误（比如返回码、错误缓冲区），不要在核心逻辑里处理C端的错误格式。

内容的提问来源于stack exchange，提问作者Harlan Wei