CMake集成Rust与C++混合编译实战指南

1. 项目背景与核心需求

在当今的软件开发领域，多语言混合编程已经成为一种常见的技术方案。Rust作为一门新兴的系统级编程语言，凭借其出色的内存安全性和高性能特性，正在被越来越多的项目采用。而C/C++作为传统的系统编程语言，拥有庞大的现有代码库和生态系统。如何让这两种技术栈高效协同工作，成为了许多开发者面临的实际问题。

这个项目要解决的核心问题是：如何在CMake构建系统中集成Cargo（Rust的包管理器和构建工具），实现Rust代码与C/C++代码的混合编译，最终生成动态链接库（.so或.dll文件）。这种技术方案特别适用于以下场景：

• 在现有C/C++项目中逐步引入Rust模块
• 需要利用Rust的安全特性重构C/C++中的关键组件
• 开发需要高性能和内存安全的跨语言接口
• 构建包含多种语言组件的复杂系统

2. 技术选型与工具链配置

2.1 工具链准备

要实现Rust与C/C++的混合构建，我们需要配置以下工具链：

1. Rust工具链：

   • 安装Rustup（Rust工具链安装器）
   • 通过rustup install stable安装稳定版Rust
   • 确保Cargo（Rust的包管理器）可用

2. C/C++工具链：

   • GCC或Clang编译器
   • CMake（3.12或更高版本）
   • 对应平台的构建工具（如make、ninja）

3. 交叉编译支持（如需要）：

   • 目标平台的工具链
   • Rust目标支持（通过rustup target add添加）

提示：在Windows平台上，还需要安装Visual Studio的C++构建工具或MinGW-w64。

2.2 项目结构设计

一个典型的混合语言项目可以按照以下结构组织：

code复制project-root/
├── CMakeLists.txt        # 主CMake配置文件
├── rust/
│   ├── Cargo.toml        # Rust包配置文件
│   ├── src/
│   │   └── lib.rs        # Rust库主文件
│   └── build.rs          # Rust构建脚本
├── cpp/
│   ├── CMakeLists.txt    # C++子项目配置
│   └── src/
│       └── main.cpp      # C++主程序
└── include/              # 公共头文件

这种结构保持了两种语言代码的相对独立性，同时通过CMake进行统一管理。

3. Rust动态库的构建配置

3.1 Cargo.toml配置

要让Rust生成可供C/C++调用的动态库，需要在Cargo.toml中进行如下配置：

toml复制[package]
name = "my_rust_lib"
version = "0.1.0"
edition = "2021"

[lib]
name = "my_rust_lib"
crate-type = ["cdylib"]  # 关键配置：生成C兼容的动态库

[dependencies]
# 添加必要的依赖项

crate-type = ["cdylib"]这一行是关键，它告诉Cargo生成一个与C ABI兼容的动态库，而不是Rust默认的rlib格式。

3.2 编写FFI接口

Rust代码需要通过extern "C"块暴露C兼容的函数接口。以下是一个示例：

rust复制// src/lib.rs
use std::os::raw::c_int;

#[no_mangle]
pub extern "C" fn