跨平台开发 / 系统课时

写第一个 Dart 单元测试

写第一个 Dart 单元测试

单元测试用于验证独立代码单元是否符合预期行为。本篇通过 Dart 的 test 包编写第一个测试,理解测试结构、断言方式以及如何验证业务逻辑。

学习目标

  • 掌握 Dart 单元测试的基本结构。
  • 使用 expect 和 matcher 验证函数结果。
  • 学会运行测试并根据结果定位问题。

认识 Dart 测试结构

Dart 测试通常由测试描述、执行代码和断言组成。Flutter 项目默认使用 test 包提供测试能力,适合验证纯函数、数据转换类和业务规则。

一个简单测试需要引入 test 包,并使用 test 方法描述测试场景。

编写第一个单元测试

下面示例测试一个订单折扣计算函数。完整代码包含业务函数和测试入口,适合作为独立 Dart 测试文件运行。

dart
import 'package:test/test.dart';

double calculateDiscount(double price, bool member) {
  // 会员享受固定折扣,普通用户保持原价
  return member ? price * 0.9 : price;
}

void main() {
  test('member receives discount', () {
    final result = calculateDiscount(100, true);

    expect(result, equals(90));
  });
}

预期输出

text
00:00 +1: member receives discount
00:00 +1: All tests passed!

测试输出中的时间和格式可能因运行环境不同略有差异,但成功状态表示断言通过。

理解 expect 与 matcher

expect 负责比较实际结果和预期结果,matcher 描述允许的结果形式。常用 matcher 包括 equals、isTrue、isFalse 和 throwsException。

例如,验证布尔结果时可以这样写:

dart
expect(isMember, isTrue);

预期结果

text
The assertion passes when isMember is true.

选择合适的 matcher 可以让失败信息更明确,帮助快速定位业务规则错误。

运行测试并处理失败

Dart 测试文件通常放在 test 目录下,可以使用以下命令执行:

bash
dart test

预期输出

text
All tests passed!

如果断言失败,测试框架会显示实际值和期望值的差异。排查时应优先检查输入数据、业务规则和测试假设是否一致。

编写有效单元测试

好的单元测试应该关注行为而不是实现细节。测试业务结果时,不要依赖私有变量或内部调用顺序,否则代码重构会导致大量无意义修改。

对于 Flutter 应用,优先为纯业务逻辑、状态转换和数据处理编写单元测试,再根据需求增加 Widget 测试和集成测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

写第一个 Dart 单元测试

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

登录哪都通