使用CMake在C项目中调用Rust代码时出现链接错误

以下是针对你遇到的链接错误的排查方向和解决方法：

• 检查链接顺序
  静态库的链接顺序遵循"依赖者在前，被依赖者在后"的规则，必须将调用Rust函数的C目标放在Rust静态库之前链接。
  错误示例：

  target_link_libraries(my_app librust_lib.a main.o)
  

  正确示例：

  target_link_libraries(my_app main.o librust_lib.a)
  

  推荐用CMake导入库的方式管理，让CMake自动处理顺序：

  add_library(rust_lib STATIC IMPORTED)
  set_target_properties(rust_lib PROPERTIES
      IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/rust_lib/target/your-target-triple/release/librust_lib.a"
  )
  target_link_libraries(my_app PRIVATE rust_lib)
  

• 验证交叉编译架构一致性
  确保Rust静态库的编译目标与C项目的交叉编译目标完全匹配：

  1. 用file librust_lib.a查看Rust库的架构信息
  2. 用file main.o查看C目标文件的架构信息
  3. 若不匹配，重新编译Rust库：cargo build --target <your-target-triple> --release（比如arm-unknown-linux-gnueabihf）

• 确认C声明与Rust定义严格匹配
  C头文件中的函数声明必须和Rust的定义完全一致：
  Rust代码：

  #[no_mangle]
  pub extern "C" fn rust_function() {
      // 函数实现
  }
  

  C头文件main.h：

  extern void rust_function(void);
  

  注意返回值、参数列表、调用约定必须完全对应，避免因签名不匹配导致符号无法识别。

• 补充Rust标准库依赖
  Rust静态库可能依赖Rust标准库或系统库，交叉编译时需要手动引入这些依赖：

  1. 执行cargo rustc --target <your-target-triple> -- --print native-static-libs，查看Rust依赖的系统库
  2. 在CMake中将这些库加入链接列表，例如：

     target_link_libraries(my_app PRIVATE rust_lib -lgcc -ldl -lpthread -lm)
     

• 排查自定义库合并逻辑
  如果你用自定义命令合并所有库，确保librust_lib.a被正确包含到合并后的库中，且合并顺序符合链接规则。例如用ar命令合并时，需将Rust库放在靠后的位置：

  ar cr merged_lib.a other_libs.a main.o librust_lib.a
  

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