如何在CentOS上构建Rust静态库

在CentOS上构建Rust静态库，其实流程并不复杂，但有几个关键点需要注意。下面把每一步拆开来，结合一些实际经验，说清楚怎么操作。

1. 安装Rust

首先，你得先把Rust装上。如果还没装，直接去 Rust 官方网站 按说明来就行。安装完成后，验证一下：

rustc --version

能看到版本号，就说明环境就绪了。这一步没什么门槛，但要注意，CentOS默认的软件源里Rust版本可能比较旧，所以推荐用官方推荐的 rustup 安装方式。

2. 创建一个新的Rust库项目

接着，用 cargo new 命令新建一个库项目。名字可以自己起，这里用 my_static_lib 做示例：

cargo new --lib my_static_lib

这条命令会在当前目录下生成一个 my_static_lib 文件夹，里面已经搭好了基本的库项目骨架。打开看看，会发现 src/lib.rs 和 Cargo.toml 两个文件。

3. 配置Cargo.toml文件

关键的一步来了：要让 cargo 知道我们想要的是静态库，而不是动态库。打开 Cargo.toml，在 [lib] 部分添加或修改成下面这样：

[lib]
name = "my_static_lib"
crate-type = ["staticlib"]

这里 crate-type = ["staticlib"] 就是告诉编译器：生成 .a 文件（Linux上的静态库）。如果漏掉这一步，默认生成的是 rlib 格式，那在其他项目里引用时可能会遇到一些麻烦。

4. 编写Rust代码

接下来，在 src/lib.rs 里写你的库函数。比如一个简单的打招呼函数：

pub fn hello() {
    println!("Hello from my_static_lib!");
}

注意 pub 关键字，它让函数对外可见。如果漏了，外部项目就调用不了。

5. 构建静态库

代码写好后，在项目目录下执行：

cargo build --release

编译完成后，静态库文件会出现在 target/release 目录下，名字是 libmy_static_lib.a。如果编译成功，说明整个过程已经走通了。

6. 使用静态库

现在，你可以在另一个Rust项目里引用这个静态库了。假设你有一个新项目，需要把这个库放进去。通常的做法是：

• 把 libmy_static_lib.a 复制到目标项目的某个目录下，比如 libs/。
• 在目标项目的 Cargo.toml 中，添加依赖路径：

[dependencies]
my_static_lib = { path = "libs/my_static_lib" }

然后在 src/main.rs 里调用：

extern crate my_static_lib;

fn main() {
    my_static_lib::hello();
}

最后，在目标项目里执行 cargo build --release，如果一切顺利，就能看到 Hello from my_static_lib! 的输出。

这里有一点需要特别说明：上述步骤基于 Rust 1.56 及以上版本。如果你用的是更老的版本，某些地方（比如 crate-type 的写法）可能需要微调，但整体思路是一样的。

总结一下，在CentOS上构建Rust静态库，本质就是三步：配置 crate-type = ["staticlib"]、编写代码、编译生成 .a 文件。至于如何引用，路径配好就行了。整个过程没有太多坑，唯一要留意的就是版本兼容性。