Linux系统中Rust如何编写单元测试

在Linux环境下用Rust写单元测试，其实比想象中要直白得多。Rust语言本身就内置了一套测试框架，核心就是那个#[test]属性——你只需要把它标注在函数上，测试运行器就会自动识别并执行。下面咱们一步步拆解整个过程。

第一步，先创建一个Rust项目。如果还没动手，用下面任意一条命令就行：

cargo new my_project --lib

或者

cargo new my_project --bin

前者生成库项目，后者生成二进制项目。具体选哪个，看你当前的需求。

第二步，在对应的源文件里写一个待测函数。以库项目为例，打开src/lib.rs（二进制项目则是src/main.rs），比如：

// src/lib.rs 或 src/main.rs
pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

第三步，在同一个文件中编写测试代码。通常的做法是单独建一个tests模块，用#[cfg(test)]属性包裹——这样测试代码只在运行cargo test时才会被编译，不会影响正常构建。模块内部再用use super::*;把父模块的公开项引入进来，然后写一个以#[test]标记的函数：

#[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);
    }
}

这里有几个关键点值得注意：

• #[cfg(test)] 就像一个“条件编译”开关，确保测试代码只在测试模式下生效。
• use super::*; 把当前模块（也就是tests模块的父模块）中的所有公开项导入进来，这样就能直接调用add函数了。
• #[test] 是测试函数的标志，Rust的测试运行器会自动扫描所有带这个属性的函数并执行它们。

第四步，保存文件，然后在终端运行：

cargo test

你会看到编译过程，接着是测试结果。如果所有断言都通过，终端会显示“test result: ok”；如果有失败的，会明确指出哪个测试在哪一行没通过，以及期望值和实际值分别是多少——这调试起来非常方便。

当然，实际项目中往往需要更多测试用例来覆盖边界情况、错误处理等等。方法完全一样：多写几个带#[test]的函数，每个函数里放上若干assert_eq!、assert!或assert_ne!断言即可。Rust的测试框架本身足够轻量，但功能一点也不弱——从简单到复杂，这套流程都能支持。