跨平台开发 / 系统课时

编写一个 Widget 测试

编写一个 Widget 测试

本篇将使用 flutter_test 为 Flutter 组件建立自动化验证,让你能够检查 Widget 是否正确渲染、用户操作是否触发预期行为,并掌握日常开发中定位 UI 问题的基础测试方式。

学习目标

  • 理解 Widget 测试与普通单元测试的区别。
  • 使用 flutter_test 编写组件渲染和交互验证。
  • 掌握运行测试与分析失败原因的方法。

认识 Widget 测试的验证范围

Flutter 应用中的 Widget 测试运行在测试环境中,会创建 Widget 树并模拟用户操作。它关注的是组件组合后的行为,例如文本是否显示、按钮点击后状态是否变化,而不是验证单个函数的计算逻辑。

常见测试对象包括:

  • 页面初始渲染是否符合预期。
  • 用户点击、输入等交互是否产生正确结果。
  • Widget 之间的数据传递是否正确。

一个完整的 Widget 测试通常包含三个阶段:创建测试环境、构建 Widget、执行断言验证。

使用 flutter_test 编写组件测试

Flutter 项目默认已经包含 flutter_test 依赖。下面创建一个简单计数器 Widget,并通过测试验证点击按钮后的文本变化。

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

class CounterWidget extends StatefulWidget {
  const CounterWidget({super.key});

  @override
  State<CounterWidget> createState() => _CounterWidgetState();
}

class _CounterWidgetState extends State<CounterWidget> {
  int count = 0;

  void increment() {
    setState(() {
      count++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Text('$count'),
        ElevatedButton(
          onPressed: increment,
          child: const Text('增加'),
        ),
      ],
    );
  }
}

void main() {
  testWidgets('点击按钮后数字增加', (WidgetTester tester) async {
    await tester.pumpWidget(
      const MaterialApp(
        home: Scaffold(
          body: CounterWidget(),
        ),
      ),
    );

    expect(find.text('0'), findsOneWidget);

    await tester.tap(find.text('增加'));
    await tester.pump();

    expect(find.text('1'), findsOneWidget);
  });
}

预期输出

text
00:00 +0: 点击按钮后数字增加
00:00 +1: All tests passed!

pumpWidget 会加载测试 Widget,pump 会触发一次 Widget 更新流程。测试中的 find 用于定位组件,expect 用于判断实际结果是否符合预期。

理解测试失败的定位方式

Widget 测试失败时,优先查看断言位置,而不是直接修改代码。常见原因包括:

  • Widget 没有被正确包裹在需要的上下文中,例如缺少 MaterialApp。
  • 异步状态更新后没有调用 pump 或 pumpAndSettle。
  • 查找条件与实际 Widget 内容不一致。

例如,动画、网络加载等异步场景通常需要等待 Widget 稳定后再验证。

什么时候应该使用 Widget 测试

Widget 测试适合验证用户可见行为,例如登录表单、列表页面、按钮交互和组件组合。对于纯业务计算逻辑,使用 Dart 单元测试通常更简单;对于完整应用流程,则应考虑集成测试。

合理划分测试类型,可以让测试运行速度和维护成本保持平衡。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写一个 Widget 测试

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

登录哪都通