Linux下Rust的单元测试如何编写与执行

在Linux下编写和执行Rust单元测试

对于Rust开发者来说，单元测试是保障代码质量的第一道防线。好消息是，Rust语言内置了完整的测试框架，这意味着你不需要安装任何额外的依赖，开箱即用。下面，我们就来一步步看看如何在Linux环境下，为你的Rust代码编写并运行单元测试。

第一步：创建项目

如果你还没有现成的项目，可以先用Cargo创建一个。打开终端，执行以下命令：

cargo new my_project
cd my_project

第二步：编写待测试的代码

接下来，在源代码文件中添加你想要测试的函数或模块。对于库项目，代码通常放在src/lib.rs；如果是可执行文件，则放在src/main.rs。

这里以库项目为例，在src/lib.rs中定义一个简单的加法函数：

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

第三步：编写测试函数

真正的测试工作从这里开始。在Rust中，测试代码通常就放在被测试代码的下方，用专门的测试模块组织起来。这里有个关键点：测试函数必须用#[test]属性来标记。它们的签名也和普通函数略有不同，通常不接收参数，也不返回值，所以用()表示。

继续在src/lib.rs文件中，添加以下测试模块和函数：

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

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

可以看到，我们使用了assert_eq!宏来断言函数的输出是否符合预期。一个测试函数里包含多个断言是很常见的做法，旨在覆盖不同的输入场景。

第四步：运行测试

代码写好了，是时候验证它是否工作了。保存文件，然后在项目根目录下运行一个简单的命令：

cargo test

Cargo会自动编译项目，并运行所有带有#[test]标记的函数。控制台会清晰地展示测试结果：通过了多少，失败了哪些，如果失败，原因是什么。这套流程非常高效，能让你快速得到反馈。

第五步：查看详细输出（可选）

有时候，你可能需要查看测试过程中打印到标准输出（stdout）的信息，比如一些调试日志。默认情况下，Cargo在测试时会捕获这些输出。如果想看到它们，可以加上--nocapture标志：

cargo test --nocapture

至此，一个完整的Rust单元测试流程就完成了。你可以遵循这个模式，为项目中更多的函数和模块添加测试，逐步构建起一个坚实的测试网，从而确保代码在各种情况下的正确性和稳定性。记住，好的测试习惯，是写出健壮软件的关键。