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

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

对于Rust开发者而言，单元测试是保障代码质量的关键环节。Rust语言内置了完整的测试框架，无需安装额外依赖即可开箱使用。本文将详细介绍如何在Linux环境中，为你的Rust代码编写并运行单元测试。

第一步：创建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
}

第三步：编写测试函数

测试代码通常放置在被测试代码附近，并通过测试模块进行组织。测试函数需使用#[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]标记的函数。控制台将清晰展示测试结果，包括通过数量、失败案例及失败原因。该流程高效便捷，有助于快速获得反馈。

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

若需查看测试过程中打印至标准输出的调试信息，可在测试命令后添加--nocapture标志：

cargo test --nocapture

至此，你已完成Rust单元测试的完整流程。可遵循此模式为项目中更多函数与模块添加测试，逐步构建完善的测试体系，从而确保代码在不同场景下的正确性与稳定性。良好的测试习惯是开发健壮软件的重要基础。