跨平台开发 / 系统课时

用 setUp 复用前置状态

用 setUp 复用前置状态

多个测试需要相同初始数据时,复制准备代码会让维护成本迅速上升;把同一个可变对象放到全局复用,又会产生顺序依赖。本节用 setUp 为每个测试创建独立 fixture,并用 tearDown 清理临时资源。

学习目标

  • 理解 setUp 与 tearDown 在每个测试前后的执行职责
  • 为每个测试创建全新的可变状态,避免测试互相污染
  • 判断哪些准备逻辑适合复用,哪些断言仍应留在具体测试中

setUp 复用的是准备过程

setUp 的价值不是“让所有测试共享一个对象”,而是让同一段初始化逻辑在每个测试开始前重新执行。这样测试可以获得一致起点,同时保留彼此隔离的状态。

对于内存对象,通常只需要在 setUp 中重新创建实例;对于临时文件、数据库连接或其他外部资源,还应在 tearDown 中释放,避免资源残留影响后续测试。

为每个测试创建独立 fixture

下面的示例为每个测试创建独立临时目录,并写入相同的初始配置文件。某个测试即使修改文件,也不会污染其他测试,因为下一次 setUp 会重新创建资源。

dart
import 'dart:io';

import 'package:test/test.dart';

void main() {
  late Directory tempDir;
  late File settingsFile;

  setUp(() {
    tempDir = Directory.systemTemp.createTempSync('dart-quality-');
    settingsFile = File(
      '${tempDir.path}${Platform.pathSeparator}settings.txt',
    );

    // 每个测试都从同一份初始数据开始。
    settingsFile.writeAsStringSync('theme=light');
  });

  tearDown(() {
    if (tempDir.existsSync()) {
      tempDir.deleteSync(recursive: true);
    }
  });

  test('reads the seeded settings', () {
    expect(settingsFile.readAsStringSync(), 'theme=light');
  });

  test('can modify only its own fixture', () {
    settingsFile.writeAsStringSync('theme=dark');
    expect(settingsFile.readAsStringSync(), 'theme=dark');
  });

  test('starts from the seed content again', () {
    expect(settingsFile.readAsStringSync(), 'theme=light');
  });
}

预期输出(保存为 test/settings_file_test.dart 后执行 dart test test/settings_file_test.dart):

text
<TIME> +3: All tests passed!

<TIME> 是实际运行耗时。第二个测试把文件改成了 theme=dark,第三个测试仍然读取到 theme=light,说明它拿到的是新的临时目录与文件,而不是前一个测试留下的状态。

不要把可变状态放到 setUp 外复用

如果在 main 顶层先创建一次 List、缓存对象或测试数据库,再让所有测试共同修改它,测试结果就可能依赖执行顺序。单独运行某个测试时通过,整组运行时却失败,通常就是共享可变状态留下的信号。

late 变量本身没有问题,关键在于赋值发生在哪里。像示例那样在 setUp 内重新赋值,变量只是让测试访问当前 fixture;如果只在外部初始化一次,它就变成了跨测试共享状态。

清理逻辑只负责恢复环境

tearDown 适合关闭连接、删除临时目录、恢复环境变量等资源清理,不应塞入测试断言。断言属于具体测试;清理阶段的职责是尽量把环境恢复到测试开始前的状态。

当准备过程需要异步操作时,setUp 和 tearDown 的回调也可以返回 Future,测试框架会等待它们完成。无论同步还是异步,都应保持同一个原则:前置钩子创建独立状态,后置钩子释放外部资源,测试本身只关注当前行为。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 setUp 复用前置状态

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

登录哪都通