Dart/Flutter 新增逻辑或修 bug 时用…

在 Dart/Flutter 项目中为函数、方法、类编写和维护单元测试，确保新逻辑正确并避免回归。

适用场景

解决思路

1. 让测试文件结构镜像 lib 目录：例如 lib/src/utils.dart 对应 test/src/utils_test.dart，保持可预测。
2. 把所有测试代码放在包根目录的 test 目录下。
3. 所有测试文件名以 _test.dart 结尾。
4. 如果写集成测试，把它们放在包根目录的 integration_test 目录下。
5. Dart 应用统一使用 package:test 作为标准测试库。
6. 导入 package:test/test.dart；Flutter 项目导入 package:flutter_test/flutter_test.dart。
7. 使用 group() 对相关测试分组，提供共享上下文。
8. 使用 test() 定义单个测试用例。
9. 使用 expect() 配合 matcher 验证结果，例如 equals()、isTrue、throwsA()。
10. 异步测试使用标准 async/await 语法，测试运行器会自动等待 Future 完成。
11. 使用 setUp() 和 tearDown() 回调管理测试的初始化和清理。
12. 如果被测代码依赖依赖注入，配合 package:test 使用 package:mockito 生成 mock 对象、配置固定场景并验证交互。
13. 纯 Dart 项目用 dart test 执行测试。
14. Flutter 项目用 flutter test 执行测试。
15. 运行集成测试时显式指定目录路径，因为默认 runner 会忽略它：dart test integration_test 或 flutter test integration_test。
16. 在 test/ 目录创建测试文件，并确保使用 _test.dart 后缀。
17. 在测试文件中导入 package:test/test.dart 和被测目标库。
18. 定义 main() 函数。
19. 在 main() 中用 setUp() 初始化共享资源或 mock。
20. 按功能用 group() 组织，并在其中用 test() 编写测试用例。
21. 用合适的 CLI 命令执行测试套件。
22. 进入反馈循环：运行测试 -> 查看失败堆栈跟踪 -> 修复实现或断言 -> 重新运行直到通过。
23. 使用 mockito 时，通过 @GenerateNiceMocks([MockSpec<ApiClient>()]) 声明 mock，并用 dart run build_runner build 生成 mock 代码。
24. 配置 mock：用 when(mockApiClient.get('/data')).thenAnswer((_) async => ...) 固定异步返回值。
25. 执行被测系统后，用 expect 验证结果，并用 verify(mockApiClient.get('/data')).called(1) 验证交互发生次数。

适用边界 · 注意事项

• 不适用于非 Dart/Flutter 项目；该做法依赖 package:test、dart test 或 flutter test。
• 集成测试不能只放在 test/ 或用默认 dart test/flutter test 直接运行，必须在 integration_test 目录并显式指定路径。
• 纯 UI 视觉检查、真机交互或端到端流程不应只靠单元测试覆盖，需要配合 Widget/集成测试。