跨平台开发 / 系统课时
用 setUp 复用前置状态
用 setUp 复用前置状态
多个测试需要相同初始数据时,复制准备代码会让维护成本迅速上升;把同一个可变对象放到全局复用,又会产生顺序依赖。本节用 setUp 为每个测试创建独立 fixture,并用 tearDown 清理临时资源。
学习目标
- 理解
setUp与tearDown在每个测试前后的执行职责 - 为每个测试创建全新的可变状态,避免测试互相污染
- 判断哪些准备逻辑适合复用,哪些断言仍应留在具体测试中
setUp 复用的是准备过程
setUp 的价值不是“让所有测试共享一个对象”,而是让同一段初始化逻辑在每个测试开始前重新执行。这样测试可以获得一致起点,同时保留彼此隔离的状态。
对于内存对象,通常只需要在 setUp 中重新创建实例;对于临时文件、数据库连接或其他外部资源,还应在 tearDown 中释放,避免资源残留影响后续测试。
为每个测试创建独立 fixture
下面的示例为每个测试创建独立临时目录,并写入相同的初始配置文件。某个测试即使修改文件,也不会污染其他测试,因为下一次 setUp 会重新创建资源。
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):
<TIME> +3: All tests passed!<TIME> 是实际运行耗时。第二个测试把文件改成了 theme=dark,第三个测试仍然读取到 theme=light,说明它拿到的是新的临时目录与文件,而不是前一个测试留下的状态。
不要把可变状态放到 setUp 外复用
如果在 main 顶层先创建一次 List、缓存对象或测试数据库,再让所有测试共同修改它,测试结果就可能依赖执行顺序。单独运行某个测试时通过,整组运行时却失败,通常就是共享可变状态留下的信号。
late 变量本身没有问题,关键在于赋值发生在哪里。像示例那样在 setUp 内重新赋值,变量只是让测试访问当前 fixture;如果只在外部初始化一次,它就变成了跨测试共享状态。
清理逻辑只负责恢复环境
tearDown 适合关闭连接、删除临时目录、恢复环境变量等资源清理,不应塞入测试断言。断言属于具体测试;清理阶段的职责是尽量把环境恢复到测试开始前的状态。
当准备过程需要异步操作时,setUp 和 tearDown 的回调也可以返回 Future,测试框架会等待它们完成。无论同步还是异步,都应保持同一个原则:前置钩子创建独立状态,后置钩子释放外部资源,测试本身只关注当前行为。