跨平台开发 / 系统课时

组织 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;它没有独立入口,由测试文件导入后执行。

dart
double calculateOrderTotal(List<double> prices) {
  return prices.fold(0.0, (sum, price) => sum + price);
}

对应的完整测试文件保存为 test/order/order_total_test.dart。它使用一个 group 聚合相同行为,再用 test 名称描述输入条件与预期结果。

dart
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);
    });
  });
}

在项目根目录运行指定测试文件:

bash
dart test test/order/order_total_test.dart -r expanded

预期输出

text
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 解决“属于哪个行为”,测试名称解决“哪个条件失败”。三者保持一致后,测试输出本身就会成为一份可搜索的定位索引。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织 test 目录与测试分组

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

登录哪都通