跨平台开发 / 系统课时
写第一个 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 测试和集成测试。
按自己的节奏,确认真正理解。