跨平台开发 / 系统课时

让测试名称表达业务行为

让测试名称表达业务行为

测试失败时,开发者最先看到的往往不是测试代码,而是测试名称。把输入条件、业务动作和预期结果写进名称,可以让失败日志直接说明哪条业务规则被破坏,减少重新打开测试文件定位上下文的时间。

学习目标

  • 用业务条件和预期结果描述测试,而不是描述实现细节
  • 让一个测试名称与一个核心断言保持一致
  • 从测试运行结果中快速识别失败的业务行为

测试名称就是失败日志的一部分

test 的第一个参数不是随意的备注,而是测试用例的描述。像“测试运费”“case 1”“正常情况”这样的名称虽然短,但失败后无法说明输入是什么、执行了什么规则以及正确结果应该是什么。

更有信息量的名称可以按“输入或前置条件 + 动作 + 预期结果”组织。例如:订单金额低于 99 且非 VIP 时,计算运费应返回 8 元。读到名称时,即使暂时不看代码,也能知道这条测试保护的业务规则。

这并不要求所有名称机械套用 Given、When、Then。重点是让名称回答三个问题:在什么条件下、发生什么行为、应该得到什么结果。

用业务行为命名完整测试

下面的测试覆盖两条运费规则。名称直接写业务输入与结果,而不是写内部函数分支或变量名。

dart
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 后运行:

bash
flutter test test/shipping_fee_test.dart --reporter expanded

预期输出:

text
<TIME> +0: 订单金额低于 99 且非 VIP 时,计算运费应返回 8 元
<TIME> +1: 订单金额达到 99 时,计算运费应返回 0 元
<TIME> +2: All tests passed!

其中 <TIME> 是测试运行时产生的时间信息,实际值可能不同。使用展开式输出时,每条业务行为可以直接出现在测试报告中,因此 CI 失败日志也更容易检索和定位。

让名称和断言保持一致

一个名称最好只承诺一个主要业务行为。如果名称写成“优惠订单应免运费并增加积分且发送通知”,测试中又包含多个独立断言,那么任意一个断言失败都会让名称难以准确描述问题。

当多个结果属于同一个不可分割的业务结果时,可以放在同一测试中;如果它们代表不同规则,应该拆成不同测试。这样失败日志会自然指向具体规则,而不是只告诉你某个“大测试”失败了。

命名时还应避免实现细节。例如“isVip 为 true 时进入第一个 if 分支”绑定了当前代码结构;“VIP 用户计算运费时应返回 0 元”描述的是稳定的业务行为,即使以后重构实现,名称仍然成立。

检查名称是否真的有诊断价值

写完测试后,可以暂时只看测试名称,检查能否判断失败意味着什么。名称里通常应包含关键条件与可观察结果,但不需要重复测试代码中的每个参数。

如果把一条测试名称单独贴进缺陷记录,其他开发者仍能理解被破坏的规则,这个名称通常已经足够清楚。测试名称因此不仅服务于编写测试的人,也成为持续集成报告和后续维护中的业务说明。

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

目录与阅读设置

阅读设置

17

记录一个想法

让测试名称表达业务行为

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

登录哪都通