用手写的假实现、模拟的时钟和正确的 pump 直觉来测试逻辑与 widget。
在 Kodokon 中打开本课Flutter 的测试金字塔：一个由纯 Dart 单元测试构成的宽阔底座、一层 widget 测试、以及少数几个集成测试。单元测试绝不应该导入 material.dart，如果你的逻辑需要它，那问题出在架构上，而非技术上。要把代码与它的依赖隔离开，相比生成的 mock，更应优先使用手写的假实现：一个 fake 是对契约的一个简化但确实能工作的实现（内存中的仓库、可控制的时钟）；它能在重构中幸存下来，读起来也和普通代码一样。而 mock 用于验证交互（"这个方法被调用了两次"），会把测试与实现细节耦合起来，把它们留给那些交互本身就是行为的协议吧。
import 'package:flutter/foundation.dart';
abstract interface class ScoreRepository {
Future<int> fetchBest();
}
class ScoreController extends ChangeNotifier {
ScoreController(this._repository);
final ScoreRepository _repository;
int? best;
Object? error;
Future<void> load() async {
try {
best = await _repository.fetchBest();
error = null;
} on Exception catch (e) {
error = e;
}
notifyListeners();
}
}setUp 会在每一个测试之前重新创建这些对象：没有共享状态，因而也就没有任何测试会依赖于执行顺序，这正是它们可靠性的前提。可组合的匹配器（isA<Exception>()、throwsA、isNull）会产出精确的失败信息，远比一个布尔值有用。请注意下面的第二个测试：它先验证失败，紧接着再验证随后的恢复。错误路径和其他代码一样都是代码，如果它们没有被测试过，就当它们是坏的。
import 'package:flutter_test/flutter_test.dart';
class FakeScoreRepository implements ScoreRepository {
int calls = 0;
bool failNextCall = false;
@override
Future<int> fetchBest() async {
calls++;
if (failNextCall) {
failNextCall = false;
throw Exception('network unavailable');
}
return 42;
}
}
void main() {
late FakeScoreRepository repository;
late ScoreController controller;
setUp(() {
repository = FakeScoreRepository();
controller = ScoreController(repository);
});
test('exposes the best score', () async {
await controller.load();
expect(controller.best, 42);
expect(controller.error, isNull);
expect(repository.calls, 1);
});
test('captures an error then recovers', () async {
repository.failNextCall = true;
await controller.load();
expect(controller.error, isA<Exception>());
await controller.load();
expect(controller.best, 42);
expect(controller.error, isNull);
});
test('notifies its listeners', () async {
var notifications = 0;
controller.addListener(() => notifications++);
await controller.load();
expect(notifications, 1);
});
}一个 widget 测试不会向屏幕渲染任何东西：它运行在一个专门的 binding（AutomatedTestWidgetsFlutterBinding）里，在那里时间是被模拟的，每一帧都是按需产生的。pumpWidget 挂载树；pump() 推进这个假的时钟并产生一帧；pump(const Duration(milliseconds: 150)) 则在时间上向前跳跃，非常适合冻结某个中间的动画状态并加以检查。各种 Finder（find.text、find.byType、find.byKey）查询的是真实的 Element 树，而不是一张截图。因为没有什么是真正异步的，无论时钟还是网络，所以这些测试是确定性的：一次失败总是可以复现。
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
class BadgeScreen extends StatefulWidget {
const BadgeScreen({super.key});
@override
State<BadgeScreen> createState() => _BadgeScreenState();
}
class _BadgeScreenState extends State<BadgeScreen> {
bool _visible = true;
@override
Widget build(BuildContext context) {
return Scaffold(
body: Column(
children: [
if (_visible) const Text('New'),
IconButton(
icon: const Icon(Icons.close),
onPressed: () =>
setState(() => _visible = false),
),
],
),
);
}
}
void main() {
testWidgets('hides the badge after the tap',
(tester) async {
await tester.pumpWidget(
const MaterialApp(home: BadgeScreen()),
);
expect(find.text('New'), findsOneWidget);
await tester.tap(find.byIcon(Icons.close));
await tester.pump();
expect(find.text('New'), findsNothing);
});
}flutter test
flutter test test/score_controller_test.dart
flutter test --coverage
flutter test --update-goldens