掌握Rust单元测试（从零开始编写可靠的Rust测试代码）

什么是Rust单元测试？

Rust单元测试是一种用于验证单个函数或模块行为是否符合预期的自动化测试方法。Rust通过内置的#[test]属性和cargo test命令，让开发者可以快速编写并运行测试。

第一步：创建一个Rust项目

如果你还没有Rust项目，可以通过以下命令创建：

cargo new my_test_projectcd my_test_project

第二步：编写被测试的函数

打开src/lib.rs文件（如果是二进制项目则为src/main.rs），添加一个简单的加法函数：

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

第三步：编写单元测试

在同一个文件中，在函数下方添加测试模块。Rust推荐将测试代码放在一个名为tests的模块中，并使用#[cfg(test)]属性确保测试代码只在运行测试时编译：

#[cfg(test)]mod tests {    use super::*;    #[test]    fn test_add() {        assert_eq!(add(2, 3), 5);        assert_eq!(add(-1, 1), 0);        assert_eq!(add(0, 0), 0);    }}

解释一下这段代码：

• #[cfg(test)]：仅在执行cargo test时编译此模块。
• use super::*：引入父模块中的所有项（如add函数）。
• #[test]：标记该函数为测试函数。
• assert_eq!：断言两个值相等，若不等则测试失败。

第四步：运行测试

在终端中运行以下命令：

cargo test

你会看到类似如下的输出：

running 1 testtest tests::test_add ... oktest result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

常见断言宏

除了assert_eq!，Rust还提供其他有用的断言宏：

• assert!：断言表达式为真。
• assert_ne!：断言两个值不相等。
• panic!：手动触发失败（通常用于错误路径测试）。

测试失败示例

修改测试函数，故意制造一个失败：

#[test]fn test_add_fail() {    assert_eq!(add(2, 2), 5); // 这会失败！}

再次运行cargo test，你会看到详细的错误信息，帮助你快速定位问题。

总结

通过本教程，你已经学会了如何在Rust项目中编写基本的单元测试。掌握Rust测试教程中的这些技巧，不仅能提升你的代码质量，还能增强你对Rust语言入门阶段的信心。记住，良好的测试习惯是专业开发者的重要标志。

无论你是刚开始学习编写Rust测试，还是希望巩固已有知识，持续实践都是关键。现在就打开你的编辑器，为你的下一个Rust函数加上测试吧！