跨平台开发 / 系统课时

按 Arrange Act Assert 组织测试

按 Arrange Act Assert 组织测试

编写单元测试时,测试结构是否清晰会直接影响维护成本。本篇介绍 Arrange Act Assert 模式,通过固定测试步骤组织 Flutter 业务逻辑测试,让失败位置和原因更容易定位。

学习目标

  • 理解 Arrange Act Assert 三个阶段分别承担的职责
  • 使用 AAA 模式编写结构清晰的 Flutter 单元测试
  • 根据测试失败位置快速判断业务逻辑问题

为什么需要固定测试结构

业务测试通常包含准备数据、执行行为、验证结果三个过程。如果这些过程混杂在一起,测试代码会随着业务增长变得难以阅读,失败时也很难判断问题来自初始化、执行过程还是断言。

Arrange Act Assert(AAA)是一种常见测试组织方式:

  • Arrange:准备测试环境、输入数据和依赖对象
  • Act:执行被测试的方法或操作
  • Assert:验证执行结果是否符合预期

这种结构不是 Flutter 专属规则,而是一种帮助测试代码表达意图的编排方式。

在 Flutter 单元测试中划分三个阶段

以一个简单的购物车业务为例,测试添加商品后的数量变化。

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

class Cart {
  final List<String> items = [];

  void add(String item) {
    items.add(item);
  }

  int get count => items.length;
}

void main() {
  test('add item increases cart count', () {
    // Arrange:创建被测试对象并准备输入
    final cart = Cart();

    // Act:执行实际业务操作
    cart.add('keyboard');

    // Assert:验证业务结果
    expect(cart.count, 1);
  });
}

预期输出

text
00:00 +1: add item increases cart count
All tests passed!

测试代码中,每个阶段只有一个职责。当断言失败时,可以快速确认是商品添加逻辑错误,还是测试数据准备不正确。

AAA 模式在复杂业务中的使用

实际项目中,Act 阶段通常是一行调用,但 Arrange 阶段可能需要创建实体、模拟依赖或配置状态。例如测试登录服务时,Arrange 负责准备用户信息和模拟接口响应,Act 调用登录方法,Assert 验证返回结果。

不要把多个业务行为放入同一个 Act 阶段。一个测试最好验证一个主要行为,否则失败时无法快速定位具体原因。

避免 AAA 使用中的常见问题

AAA 并不要求每个测试必须严格写出三个注释,而是要求代码结构体现三个阶段。对于简单断言,额外注释可能反而降低可读性。

常见问题包括:

  • 在 Arrange 阶段执行实际业务操作,导致测试准备过程隐藏了被测行为
  • 在 Act 阶段调用多个无关方法,让测试目标不明确
  • 在 Assert 阶段验证过多无关结果,使失败信息难以分析

一个好的单元测试应该让阅读者在几秒内知道测试输入是什么、执行了什么、期待什么结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

按 Arrange Act Assert 组织测试

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

登录哪都通