如何在Linux上为Rust项目配置单元测试

在Linux上为Rust项目配置单元测试

给Rust项目配置单元测试，这事儿在Linux上其实特别简单。Rust语言本身就内置了一套好用的测试工具，核心就是这个 cargo test 命令。下面咱们就一步步来看看，怎么从零开始，把测试跑起来。

第一步：环境准备

首先，你得确保系统里已经装好了Rust。如果还没装，去Rust官网走一遍安装流程就行，跟着指示做，没什么难度。

第二步：创建项目

如果你手头还没有现成的项目，可以用 cargo new 命令快速创建一个：

cargo new my_project
cd my_project

执行完，一个名叫 my_project 的基础项目结构就生成了，该有的文件都在里面。

第三步：编写业务代码

接下来，在 src/lib.rs（如果是库项目）或者 src/main.rs（如果是可执行项目）里写你的代码。举个例子，我们在 src/lib.rs 里加一个简单的加法函数：

pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

第四步：编写测试代码

代码写好了，怎么验证它对不对呢？这就需要单元测试了。在同一个文件里，我们通常会用 #[cfg(test)] 属性来标记一个专门的测试模块。在这个模块里，每一个测试函数前面都要加上 #[test] 属性。

还是刚才那个加法函数，我们给它配上测试：

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_add() {
        assert_eq!(add(2, 2), 4);
        assert_eq!(add(-1, 1), 0);
        assert_eq!(add(0, 0), 0);
    }
}

看，这里创建了一个叫 tests 的模块，里面包含了一个 test_add 函数。assert_eq! 这个宏是关键，它用来断言两个值是否相等。如果断言失败，测试也就失败了。

第五步：运行测试

代码和测试都准备就绪，保存文件，回到终端。在项目的根目录下，输入这个魔法命令：

cargo test

命令一执行，Cargo会先编译项目，然后自动运行所有的测试。如果一切顺利，你会在终端看到类似这样的输出：

running 1 test
test tests::test_add ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

看到那个醒目的 ok 了吗？这就意味着你的测试全部通过了。

第六步：扩展测试

一个测试当然不够。随着功能增加，你可以在那个 #[cfg(test)] 模块里，尽情添加更多被 #[test] 标记的函数。每次增改之后，再跑一遍 cargo test，所有测试都会重新执行一遍。

好了，整个流程就是这样。在Linux上为Rust项目配置和运行单元测试，其实就这么直截了当。掌握了这个方法，你就能轻松地通过测试来守护代码质量，确保每一段逻辑都按预期工作。