Rust / 系统课时
为新模块制定测试分层策略
为新模块制定测试分层策略
新模块最容易出现的问题不是“没有测试”,而是测试全挤在一种层级里,导致反馈慢或边界没覆盖。本篇从模块边界、依赖类型和风险出发,确定单元、集成与属性测试各自负责什么,并给出一套可直接落地的分层方法。
学习目标
- 能根据模块边界和依赖判断主要测试层级
- 能为核心规则选择单元测试,为公开行为选择集成测试
- 能识别适合属性测试的输入空间与不变量
先按风险拆测试职责
测试分层不是按“测试类型越多越好”来设计,而是把不同风险放到最便宜、最稳定的验证位置。纯计算、状态转换和输入校验通常适合单元测试;跨模块协作、文件或网络等真实边界更适合集成测试;存在大量输入组合且规则可描述为不变量时,再考虑属性测试。
可以用三个问题快速判断:失败是否只取决于本模块内部规则?是否必须经过真实边界?是否存在难以手工穷举的输入空间? 分别对应单元、集成和属性测试的主要价值。
| 情况 | 优先测试 | 原因 |
|---|---|---|
| 订单金额计算、状态迁移 | 单元测试 | 快,失败定位直接 |
| 模块通过公开 API 协作 | 集成测试 | 验证真实边界与装配 |
| 解析器必须满足大量输入不变量 | 属性测试 | 自动探索输入组合 |
| 外部 HTTP 服务 | 集成测试加隔离依赖 | 既验证边界,又避免依赖真实服务波动 |
一个新模块的落地方法
假设模块负责解析配置并生成运行计划。先把最核心的纯逻辑抽出来,用单元测试锁定规则;再用集成测试验证模块公开入口能否正确组合解析、校验和计划生成;最后观察是否存在“输入很多、规则简单但组合爆炸”的部分,例如不同字段顺序、重复项和边界值,这类地方再加入属性测试。
Rust 的集成测试放在 tests/ 目录中,测试代码通过 crate 的公开 API 访问目标模块,因此天然适合验证模块对外契约。单元测试则通常贴近实现,适合精确定位某条规则。下面用一个最小示例展示测试层级的分工。
pub fn normalize_port(port: u16) -> u16 {
if port == 0 { 8080 } else { port }
}
#[cfg(test)]
mod tests {
use super::normalize_port;
#[test]
fn zero_port_gets_default() {
assert_eq!(normalize_port(0), 8080);
}
#[test]
fn explicit_port_is_preserved() {
assert_eq!(normalize_port(3000), 3000);
}
}预期结果
running 2 tests
test tests::explicit_port_is_preserved ... ok
test tests::zero_port_gets_default ... ok
result: ok. 2 passed; 0 failed这里的规则完全由函数自身决定,因此单元测试已经足够。若模块对外暴露 Config::build_plan(),则可以在 tests/ 中验证调用者看到的公开行为,而不是重复测试内部私有函数。
属性测试应该解决什么问题
属性测试不是“更强的单元测试”,它的重点是用一个性质约束大量生成输入。例如解析器要求“规范化后再次规范化不会改变结果”,可以表达为幂等性:。这比手工挑几个样例更适合覆盖输入组合。
选择属性测试前,先把性质写成一句可验证的话:输出始终满足约束、操作前后保持某个不变量、同一操作重复执行结果稳定等。若只能写“这组输入应该返回这个值”,传统参数化测试通常更简单。
什么时候需要三层组合
一个成熟模块不要求三种测试数量相等。常见组合是“单元测试占主体,少量集成测试保护公开契约,属性测试只覆盖高组合风险规则”。这样既能让大多数失败在本地快速反馈,又能防止模块拼装或输入空间变化时出现测试盲区。
核心原则是:测试层级跟风险走,不跟代码行数走。 新增一个纯函数,不需要为了“完整”再补一套集成测试;新增一个跨模块公开能力,也不能只测私有函数。这样形成的测试分层,才会随着模块增长继续保持可维护。