跨平台开发 / 系统课时
让测试名称表达业务行为
让测试名称表达业务行为
测试失败时,开发者最先看到的往往不是测试代码,而是测试名称。把输入条件、业务动作和预期结果写进名称,可以让失败日志直接说明哪条业务规则被破坏,减少重新打开测试文件定位上下文的时间。
学习目标
- 用业务条件和预期结果描述测试,而不是描述实现细节
- 让一个测试名称与一个核心断言保持一致
- 从测试运行结果中快速识别失败的业务行为
测试名称就是失败日志的一部分
test 的第一个参数不是随意的备注,而是测试用例的描述。像“测试运费”“case 1”“正常情况”这样的名称虽然短,但失败后无法说明输入是什么、执行了什么规则以及正确结果应该是什么。
更有信息量的名称可以按“输入或前置条件 + 动作 + 预期结果”组织。例如:订单金额低于 99 且非 VIP 时,计算运费应返回 8 元。读到名称时,即使暂时不看代码,也能知道这条测试保护的业务规则。
这并不要求所有名称机械套用 Given、When、Then。重点是让名称回答三个问题:在什么条件下、发生什么行为、应该得到什么结果。
用业务行为命名完整测试
下面的测试覆盖两条运费规则。名称直接写业务输入与结果,而不是写内部函数分支或变量名。
import 'package:flutter_test/flutter_test.dart';
double calculateShippingFee({
required double orderAmount,
required bool isVip,
}) {
// VIP 或订单满 99 元时免运费,其余订单收取固定运费。
if (isVip || orderAmount >= 99) {
return 0;
}
return 8;
}
void main() {
test('订单金额低于 99 且非 VIP 时,计算运费应返回 8 元', () {
final fee = calculateShippingFee(orderAmount: 50, isVip: false);
expect(fee, 8);
});
test('订单金额达到 99 时,计算运费应返回 0 元', () {
final fee = calculateShippingFee(orderAmount: 99, isVip: false);
expect(fee, 0);
});
}将文件保存为 test/shipping_fee_test.dart 后运行:
flutter test test/shipping_fee_test.dart --reporter expanded预期输出:
<TIME> +0: 订单金额低于 99 且非 VIP 时,计算运费应返回 8 元
<TIME> +1: 订单金额达到 99 时,计算运费应返回 0 元
<TIME> +2: All tests passed!其中 <TIME> 是测试运行时产生的时间信息,实际值可能不同。使用展开式输出时,每条业务行为可以直接出现在测试报告中,因此 CI 失败日志也更容易检索和定位。
让名称和断言保持一致
一个名称最好只承诺一个主要业务行为。如果名称写成“优惠订单应免运费并增加积分且发送通知”,测试中又包含多个独立断言,那么任意一个断言失败都会让名称难以准确描述问题。
当多个结果属于同一个不可分割的业务结果时,可以放在同一测试中;如果它们代表不同规则,应该拆成不同测试。这样失败日志会自然指向具体规则,而不是只告诉你某个“大测试”失败了。
命名时还应避免实现细节。例如“isVip 为 true 时进入第一个 if 分支”绑定了当前代码结构;“VIP 用户计算运费时应返回 0 元”描述的是稳定的业务行为,即使以后重构实现,名称仍然成立。
检查名称是否真的有诊断价值
写完测试后,可以暂时只看测试名称,检查能否判断失败意味着什么。名称里通常应包含关键条件与可观察结果,但不需要重复测试代码中的每个参数。
如果把一条测试名称单独贴进缺陷记录,其他开发者仍能理解被破坏的规则,这个名称通常已经足够清楚。测试名称因此不仅服务于编写测试的人,也成为持续集成报告和后续维护中的业务说明。