Rust / 系统课时

用 cargo test 跑通第一组测试

用 cargo test 跑通第一组测试

这篇课时从一个最小 Rust 项目开始,建立第一个可重复执行的测试。你会看到测试函数的约定、cargo test 的编译与执行过程,以及如何根据测试结果判断代码到底是通过还是失败。

学习目标

  • 能写出符合 Rust 测试约定的基础测试函数
  • 能使用 cargo test 编译、执行并定位测试结果
  • 能区分测试通过、断言失败和编译失败

测试函数长什么样

Rust 的单元测试通常放在 #[cfg(test)] 模块中,并使用 #[test] 标记测试函数。测试函数可以调用被测代码,再用 assert_eq!、assert! 等断言检查结果。

下面用一个最小库项目演示完整流程。假设当前目录已经通过 cargo new rust-test-demo --lib 创建项目,然后将 src/lib.rs 写成:

rust
pub fn add(left: i32, right: i32) -> i32 {
    left + right
}

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

    #[test]
    fn adds_two_numbers() {
        // 断言实际结果与业务期望一致。
        assert_eq!(add(2, 3), 5);
    }
}

预期结果

text
文件可以正常编译,测试定义包含 1 个可执行测试。

这里的 #[cfg(test)] 表示该模块只在测试配置下参与编译;#[test] 则告诉测试框架,这个函数需要被测试运行器发现。测试函数不需要手动调用,cargo test 会负责收集和执行它。

用 cargo test 执行

在项目根目录运行:

bash
cargo test

预期输出

text
running 1 test
test tests::adds_two_numbers ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

实际输出还会包含编译阶段信息、构建时间等内容,因此不要要求日志与示例逐字符一致。真正重要的是测试名称、ok,以及最终的 1 passed; 0 failed。

cargo test 不只是“运行函数”。它会先编译测试目标,再启动测试运行器;只要代码存在编译错误,测试甚至不会进入执行阶段。因此排查时要先判断问题发生在编译阶段还是断言阶段。

看懂失败结果

把断言暂时改成错误的期望值:

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

    #[test]
    fn adds_two_numbers() {
        assert_eq!(add(2, 3), 6);
    }
}

预期结果

text
running 1 test
test tests::adds_two_numbers ... FAILED

failures:
    tests::adds_two_numbers

test result: FAILED. 0 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out

失败信息还会给出断言位置以及实际值与期望值,定位时首先看失败测试名称和源码行号。若出现类似 mismatched types 的编译错误,则应先修复代码或测试的类型问题,而不是继续分析断言结果。

什么时候直接用 cargo test

日常开发中,改完一个函数后直接运行 cargo test 是成本最低的回归检查方式。测试数量较多时,还可以按测试名称过滤,例如只运行名称匹配 adds 的测试:

bash
cargo test adds

预期结果

text
只运行名称匹配 adds 的测试;本示例中的 tests::adds_two_numbers 会被执行并通过。

当你第一次建立测试环境时,最重要的验收标准不是输出是否漂亮,而是能够稳定复现“修改代码 → 执行 cargo test → 得到明确通过或失败结果”的闭环。这样后续增加更多测试时,测试命令本身就能成为可靠的工程入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 cargo test 跑通第一组测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通