在 Rust 中编写动态链接库（如 .so、.dll 或 .dylib）供 C 语言调用时，是否需要额外新增头文件取决于具体场景。以下是关键步骤和注意事项：

1. Rust 动态库的编写与导出

• 基本导出规则：
  Rust 函数需通过 #[no_mangle] 和 extern "C" 修饰，确保函数名和调用约定符合 C 语言的 ABI（应用二进制接口）。例如：

  1 2 3 4

  #[no_mangle] pub extern "C" fn add(a: i32, b: i32) -> i32 { a + b }

  编译时需在 Cargo.toml 中配置 crate-type = ["cdylib"] 以生成动态库。

• 复杂数据类型处理：
  若涉及结构体或字符串，需使用 #[repr(C)] 保证内存布局与 C 兼容，并通过 std::ffi::CString 转换字符串。

2. 头文件的生成与作用

• 是否需要头文件：

  • 必须生成：若 C 代码需调用 Rust 函数，头文件（.h）用于声明函数原型和数据类型，避免手动声明错误。
  • 工具生成：推荐使用 cbindgen 自动生成头文件。例如：

    1	cbindgen --crate your_rust_lib --output your_header.h

    生成的头部会包含函数声明（如 int32_t add(int32_t a, int32_t b);）和结构体定义。

• 手动编写头文件：
  若函数简单，可手动编写。例如：

  1 2	#pragma once extern int32_t add(int32_t a, int32_t b);

3. C 代码的调用与链接

• 调用步骤：

  1. 包含头文件：在 C 代码中引入生成的头文件（如 #include "your_header.h"）。
  2. 链接动态库：编译时指定库路径和名称。例如 Linux 下：

     1	gcc main.c -L./target/release -lyour_rust_lib -o main

     运行时需确保动态库在系统路径中（如设置 LD_LIBRARY_PATH）。

• 跨平台注意事项：

  • Windows 需链接 .dll 并处理 PATH 环境变量。
  • macOS 需设置 DYLD_LIBRARY_PATH。

4. 内存管理与错误处理

• 所有权问题：
  Rust 分配的内存应由 Rust 释放（如通过 Box::into_raw 和 Box::from_raw），避免 C 代码直接调用 free。
• 错误传递：
  可通过返回错误码或输出参数传递错误（如 int divide(int a, int b, int* result)）。

5. 高级场景与工具

• 自动化工具链：
  • bindgen：若需从 C 调用 Rust 复杂接口，可生成 Rust 绑定代码。
  • CMake：跨平台构建时简化链接配置。
• 性能优化：
  减少跨语言调用频率，批量处理数据以降低 FFI 开销。

总结

• 必须步骤：Rust 函数导出 + C 头文件声明 + 正确链接。
• 推荐工具：cbindgen 自动生成头文件，避免手动错误。
• 关键注意点：内存安全、ABI 兼容性及跨平台差异。

上一篇 « 下一篇 »