2Rust 系列：第二期 - 快速入门

1. 安装 Rust 环境：

在 Linux 或 macOS 上，你可以使用  rustup  来安装 Rust。运行以下命令来安装 Rust 环境：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后，确保安装了  rustfmt  组件：rustup component add rustfmt-preview

2. 安装 C2Rust：

你可以通过  cargo  从 crates.io 安装 C2Rust：cargo install c2rust

如果你需要从 Git 仓库安装最新开发版本的 C2Rust，可以使用以下命令：cargo install --git https://github.com/immunant/c2rust.git c2rust

注意：如果你的系统上安装了多个版本的 LLVM，你可能需要设置  LLVM_CONFIG_PATH  环境变量来指定正确的 LLVM 版本。

3. 生成  compile_commands.json  文件：

这个文件包含了编译 C 代码时使用的确切编译器命令。许多构建系统可以自动生成这个文件。以下是一些生成  compile_commands.json  的方法：

使用  cmake ：cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ...

使用  intercept-build （推荐用于非 cmake 项目）：pip install scan-build

intercept-build <build command>

如果你使用的是 Linux，也可以使用  bear ：bear <build command>

从  intercept-build  安装的  scan-build  工具可以捕获编译过程并生成  compile_commands.json  文件。

4. 使用 C2Rust 翻译 C 代码到 Rust：

一旦你有了  compile_commands.json  文件，就可以使用以下命令将 C 代码翻译成 Rust：c2rust transpile path/to/compile_commands.json

如果你想为 Rust 库生成  Cargo.toml  模板，可以添加  -e  选项：c2rust transpile --emit-build-files path/to/compile_commands.json

对于 Rust 二进制文件，可以这样做：c2rust transpile --main myprog path/to/compile_commands.json其中  --main myprog  告诉转译器使用  myprog.rs  中的  main  函数作为入口点。

5. 构建和运行 Rust 项目：

翻译完成后，你可以使用 Cargo 来构建和运行你的 Rust 项目：cargo build

cargo run

请注意，C2Rust 还在积极开发中，最近增加了对最新 Rust 夜间构建的支持，增加了一些新功能和 bug 修复，并为了引入一种新的生成安全 Rust 代码的方法，暂时放弃了  c2rust-refactor  工具。