跨平台开发 / 系统课时
编写与运行 Dart 测试
编写与运行 Dart 测试
这一课用 package:test 建立最小可运行测试集:通过 test 描述单个行为,用 group 组织同类场景,用 expect 验证返回值与异常路径,并用 dart test 把这些检查变成可重复执行的回归测试。
学习目标
- 使用
package:test编写并组织基础单元测试。 - 用
expect验证正常结果、边界条件和异常。 - 通过
dart test运行全部测试,并根据失败信息定位问题。
准备测试依赖与目录
标准 Dart 项目通常把测试放在根目录的 test/ 下,并将 test 包声明为开发依赖。先在项目根目录执行:
dart pub add --dev test预期输出
Resolving dependencies...
Changed <N> dependencies!实际依赖数量取决于项目已有依赖,因此用 <N> 表示。依赖安装完成后,dart test 会自动发现 test/ 目录中以 _test.dart 结尾的测试文件。
编写一个完整测试对象
先创建 lib/calculator.dart,放入待测试逻辑。这个函数只接受非负除数;除数为零时主动抛出 ArgumentError,让失败路径可被明确验证。
double safeDivide(double dividend, double divisor) {
if (divisor == 0) {
throw ArgumentError.value(divisor, 'divisor', 'must not be zero');
}
return dividend / divisor;
}这是被测代码,不需要单独运行;它会由测试文件导入并调用。接着创建 test/calculator_test.dart:
import 'package:test/test.dart';
import '../lib/calculator.dart';
void main() {
group('safeDivide', () {
test('returns quotient for a valid divisor', () {
expect(safeDivide(12, 3), equals(4));
});
test('supports fractional results', () {
expect(safeDivide(5, 2), closeTo(2.5, 0.000001));
});
test('throws when divisor is zero', () {
expect(
() => safeDivide(10, 0),
throwsA(isA<ArgumentError>()),
);
});
});
}group 只负责组织测试名称,不改变执行语义;每个 test 应聚焦一个可说明的行为。expect 的第一个参数是实际值或待执行函数,第二个参数是 matcher。异常测试要传入闭包,否则异常会在 expect 接管前就被抛出。
运行测试并读取结果
在项目根目录运行全部测试:
dart test预期输出
00:00 +3: All tests passed!时间可能不同,但 +3 表示三个测试通过,最终的 All tests passed! 表示本次回归检查成功。测试文件较多时,命令会自动汇总多个文件的结果。
也可以只运行当前文件,以缩短定位周期:
dart test test/calculator_test.dart预期输出
00:00 +3: All tests passed!当你正在修改单个模块时,先跑目标文件能更快获得反馈;准备提交前再执行一次完整的 dart test。
验证失败信息是否可定位
测试真正有价值的前提是失败时能告诉你“哪个行为坏了”。例如把正常路径的预期值故意改错:
test('returns quotient for a valid divisor', () {
expect(safeDivide(12, 3), equals(5));
});运行:
dart test test/calculator_test.dart预期输出
00:00 +0 -1: safeDivide returns quotient for a valid divisor [E]
Expected: <5>
Actual: <4.0>
Some tests failed.行号、耗时和周边堆栈会随环境变化,但失败测试名称、期望值与实际值应直接帮助定位问题。修复断言后再次执行测试,结果应恢复为全部通过。
把测试变成回归检查
稳定的提交前顺序可以是先格式化与分析,再运行测试。测试与静态分析关注的问题不同:分析器检查类型和规则,测试验证实际行为,二者不能互相替代。
dart format --output=none --set-exit-if-changed .
dart analyze
dart test预期输出
Formatted <N> file(s) (0 changed) in <TIME> seconds.
Analyzing <PROJECT>...
No issues found!
00:00 +3: All tests passed!把这组命令固定到本地提交检查或 CI 后,每次变更都要重新证明“代码格式正确、静态分析通过、既有行为未回归”,测试才真正成为可重复执行的工程保障。