Rust / 系统课时

编写集成测试

编写集成测试

集成测试要验证的是 crate 对外承诺是否成立,而不是直接触碰内部实现。本节用一个最小库演示如何把测试放进 tests 目录,只通过公共 API 检查多个内部模块协作后的结果,并掌握单独运行某个集成测试文件的方法。

学习目标

  • 理解 tests 目录中的测试与单元测试在 crate 边界上的差异
  • 从公共 API 编写可运行的集成测试并验证成功、失败分支
  • 使用 cargo test --test 精确运行指定测试目标

集成测试放在哪里

Cargo 会把项目根目录下 tests 中的每个 .rs 文件编译成独立的测试 crate。因为它站在库的外部,所以只能访问 pub 暴露的接口;pub(crate)、私有函数和私有模块都不能直接调用。

这种边界很适合验证“调用方真实能做什么”。如果一个公共函数内部串联了库存、计价、解析或持久化等多个模块,集成测试只检查最终行为,不需要知道内部协作细节。

先创建一个最小库项目:

bash
cargo new --lib shop_core
cd shop_core

预期输出:

text
Creating library `shop_core` package

提示中的附加说明会随 Cargo 版本变化,但项目目录和 Cargo.toml、src/lib.rs 会被创建。

从公共接口验证模块协作

把 src/lib.rs 替换为下面的完整代码。两个内部模块保持私有,只公开 checkout_total:

rust
mod inventory {
    pub(crate) fn available(stock: u32, quantity: u32) -> bool {
        stock >= quantity
    }
}

mod pricing {
    pub(crate) fn subtotal(unit_price: u64, quantity: u32) -> u64 {
        unit_price * u64::from(quantity)
    }
}

pub fn checkout_total(
    unit_price: u64,
    quantity: u32,
    stock: u32,
) -> Result<u64, &'static str> {
    if !inventory::available(stock, quantity) {
        return Err("insufficient stock");
    }

    Ok(pricing::subtotal(unit_price, quantity))
}

这是库实现文件,本身不产生控制台输出;后面的 cargo test 会同时编译它和集成测试并完成验证。

新建 tests/checkout.rs:

rust
use shop_core::checkout_total;

#[test]
fn returns_total_when_stock_is_enough() {
    let result = checkout_total(25, 3, 10);

    assert_eq!(result, Ok(75));
}

#[test]
fn rejects_when_stock_is_insufficient() {
    let result = checkout_total(25, 3, 2);

    assert_eq!(result, Err("insufficient stock"));
}

该文件也是完整测试源码,不单独运行;由 Cargo 作为名为 checkout 的集成测试目标执行。运行:

bash
cargo test --test checkout

预期输出:

text
running 2 tests
test rejects_when_stock_is_insufficient ... ok
test returns_total_when_stock_is_enough ... ok

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

编译耗时、构建路径等动态内容可能不同,但应看到两个测试都通过。

精确运行和组织测试

--test checkout 指向 tests/checkout.rs 生成的测试目标。还可以在后面追加测试名过滤器,只运行一个用例:

bash
cargo test --test checkout rejects_when_stock_is_insufficient

预期输出:

text
running 1 test
test rejects_when_stock_is_insufficient ... ok

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

当多个集成测试需要共享测试数据或构造函数时,可以把辅助代码放进 tests/common/mod.rs,再由各测试文件以 mod common; 引入。不要把只为测试服务的辅助函数暴露进正式公共 API。

什么时候应该写集成测试

当目标是验证“用户通过公共接口完成一件完整事情”时,优先写集成测试,例如一次解析再计算、一次请求跨多个模块完成处理,或一个库的公开类型需要组合使用。若只想覆盖某个私有函数的边界条件,单元测试通常更直接。

集成测试失败时,先判断是公共行为真的回归,还是测试错误依赖了实现细节。只要测试始终围绕公开契约编写,内部模块即使重构,正确的集成测试也应继续通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写集成测试

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

登录哪都通