单元测试简介

当你添加更多功能或更改现有功能时，如何确保你的应用能继续正常工作？通过编写测试。

单元测试对于验证单个函数、方法或类的行为非常有用。test 包提供了编写单元测试的核心框架，而 flutter_test 包则提供了用于测试 Widget 的额外工具。

本指南通过以下步骤演示了 test 包提供的核心功能

1. 添加 test 或 flutter_test 依赖。
2. 创建测试文件。
3. 创建待测试类。
4. 为我们的类编写 test。
5. 将多个测试组合在 group 中。
6. 运行测试。

有关 test 包的更多信息，请参阅 test 包文档。

test 包提供了在 Dart 中编写测试的核心功能。在编写供 Web、服务器和 Flutter 应用使用的包时，这是最佳方案。

要将 test 包添加为开发依赖，请运行 flutter pub add

$ flutter pub add dev:test

在本示例中，创建两个文件：counter.dart 和 counter_test.dart。

counter.dart 文件包含你想要测试的类，位于 lib 文件夹中。counter_test.dart 文件包含测试本身，位于 test 文件夹内。

通常，测试文件应存放在 Flutter 应用或包根目录下的 test 文件夹中。测试文件应始终以 _test.dart 结尾，这是测试运行程序在搜索测试时使用的约定。

完成后，文件夹结构应如下所示

counter_app/
  lib/
    counter.dart
  test/
    counter_test.dart

接下来，你需要一个“单元”来测试。记住：“单元”是函数、方法或类的别名。在此示例中，在 lib/counter.dart 文件中创建一个 Counter 类。它负责对从 0 开始的 value 进行递增和递减操作。

class Counter {
  int value = 0;
​
  void increment() => value++;
​
  void decrement() => value--;
}

注意： 为简单起见，本教程不遵循“测试驱动开发”（TDD）方法。如果你更习惯那种开发风格，当然也可以采用。

在 counter_test.dart 文件中，编写第一个单元测试。测试是使用顶层 test 函数定义的，你可以使用顶层 expect 函数来检查结果是否正确。这两个函数均来自 test 包。

// Import the test package and Counter class
import 'package:counter_app/counter.dart';
import 'package:test/test.dart';
​
void main() {
  test('Counter value should be incremented', () {
    final counter = Counter();
​
    counter.increment();
​
    expect(counter.value, 1);
  });
}

如果你想运行一系列相关测试，请使用 flutter_test 包的 group 函数对测试进行分类。一旦放入组中，你就可以通过一条命令对该组中的所有测试调用 flutter test。

import 'package:counter_app/counter.dart';
import 'package:test/test.dart';
​
void main() {
  group('Test start, increment, decrement', () {
    test('value should start at 0', () {
      expect(Counter().value, 0);
    });
​
    test('value should be incremented', () {
      final counter = Counter();
​
      counter.increment();
​
      expect(counter.value, 1);
    });
​
    test('value should be decremented', () {
      final counter = Counter();
​
      counter.decrement();
​
      expect(counter.value, -1);
    });
  });
}

现在你已经有了带有测试的 Counter 类，可以运行测试了。

IntelliJ 和 VSCode 的 Flutter 插件支持运行测试。这通常是编写测试时的最佳选择，因为它提供了最快的反馈循环以及设置断点的能力。

• IntelliJ

  1. 打开 counter_test.dart 文件
  2. 转到 Run > Run 'tests in counter_test.dart'。你也可以按下对应平台的快捷键。

• VSCode

  1. 打开 counter_test.dart 文件
  2. 转到 Run > Start Debugging。你也可以按下对应平台的快捷键。

要从终端运行所有测试，请在项目根目录下运行以下命令

flutter test test/counter_test.dart

要运行放入 group 中的所有测试，请在项目根目录下运行以下命令

flutter test --plain-name "Test start, increment, decrement"

此示例使用了第 5 节中创建的 group。

要了解有关单元测试的更多信息，请执行此命令

flutter test --help