跨平台开发 / 系统课时
组织 test 目录与测试分组
组织 test 目录与测试分组
当测试文件增多后,真正影响排错效率的不是测试数量,而是能否从文件路径、group 名称和 test 名称迅速定位行为。本文用一个最小 Dart 示例建立可扩展的目录映射,并验证分组后的测试输出。
学习目标
- 按
lib源码结构组织对应的test文件。 - 使用
group和行为化命名让失败信息可直接定位。 - 判断何时拆分测试文件,避免单文件和分组层级失控。
让测试目录映射源码职责
对单元测试而言,最稳妥的起点是让 test 大致镜像 lib 的职责边界。源码位于 lib/order/order_total.dart,对应测试就放在 test/order/order_total_test.dart。这样看到失败路径时,不必再猜它覆盖哪个模块。
| 源码 | 对应测试 | 适合验证的内容 |
|---|---|---|
lib/order/order_total.dart |
test/order/order_total_test.dart |
订单金额计算规则 |
lib/user/user_name.dart |
test/user/user_name_test.dart |
用户名校验与规范化 |
文件名通常以 _test.dart 结尾,这是 dart test 默认发现测试文件时采用的约定。辅助构造器、固定样本等共享代码可以放到 test/support,但不要把被测业务逻辑复制到测试目录,否则测试可能验证的是副本而不是生产代码。
用 group 表达行为边界
下面示例假设项目已经添加 test 开发依赖。片段示例:将以下生产代码保存为 lib/order/order_total.dart;它没有独立入口,由测试文件导入后执行。
double calculateOrderTotal(List<double> prices) {
return prices.fold(0.0, (sum, price) => sum + price);
}对应的完整测试文件保存为 test/order/order_total_test.dart。它使用一个 group 聚合相同行为,再用 test 名称描述输入条件与预期结果。
import 'package:test/test.dart';
import '../../lib/order/order_total.dart';
void main() {
group('calculateOrderTotal', () {
test('returns 0 for an empty order', () {
expect(calculateOrderTotal([]), 0.0);
});
test('sums all item prices', () {
expect(calculateOrderTotal([12.5, 7.5]), 20.0);
});
});
}在项目根目录运行指定测试文件:
dart test test/order/order_total_test.dart -r expanded预期输出
00:00 +0: calculateOrderTotal returns 0 for an empty order
00:00 +1: calculateOrderTotal sums all item prices
00:00 +2: All tests passed!时间前缀可能因机器速度不同而变化,但输出中的“分组名 + 测试名”应能直接说明当前执行的是哪个行为。
命名要帮助定位而不是复述代码
好的测试名优先描述行为,例如 rejects negative price、returns 0 for an empty order。test1、works 或 calculateOrderTotal test 虽然能运行,却几乎不能帮助定位失败原因。
group 也不宜按“正常情况”“异常情况”无限套娃。通常一层用来表示函数、类或业务能力就够了;只有同一能力下存在明显子场景时才增加第二层。分组越深,失败输出越长,维护时越难扫描。
什么时候拆分测试文件
当一个测试文件同时覆盖多个独立类、需要大量不相关的 setUp,或失败时必须在几十个测试之间寻找上下文,就应该按源码职责拆开。相反,只有两三个紧密相关行为时,没有必要为了“一个测试一个文件”制造碎片。
目录映射解决“去哪找”,group 解决“属于哪个行为”,测试名称解决“哪个条件失败”。三者保持一致后,测试输出本身就会成为一份可搜索的定位索引。