跨平台开发 / 系统课时
用 switch 匹配联合分支
用 switch 匹配联合分支
Freezed 联合类型只有在消费端能安全区分分支时才真正有价值。本节使用 Dart 3 的 switch 与对象模式直接解构不同分支,并利用 sealed 类型的穷尽性检查,让新增分支时遗漏的业务逻辑在编译阶段暴露。
学习目标
- 用对象模式匹配 Freezed 联合类型的具体分支
- 在匹配时直接提取分支字段,减少强制转换
- 保留穷尽性检查,让新增分支触发静态错误
用模式代替 runtimeType 判断
不要先读取 runtimeType 再做字符串或类型比较。对于 sealed 联合类型,直接对对象本身做模式匹配,编译器才能理解“有哪些可能分支”,并在分支不完整时参与检查。

下面示例保存为 lib/switch_demo.dart,项目需已配置 freezed_annotation、freezed 与 build_runner。
import 'package:freezed_annotation/freezed_annotation.dart';
part 'switch_demo.freezed.dart';
@freezed
sealed class LoadState with _$LoadState {
const factory LoadState.loading() = LoadingState;
const factory LoadState.data(List<String> items) = DataState;
const factory LoadState.error(String message) = ErrorState;
}
String describe(LoadState state) => switch (state) {
LoadingState() => '加载中',
DataState(:final items) => '共 ${items.length} 条',
ErrorState(:final message) => '失败:$message',
};
void main() {
final states = <LoadState>[
const LoadState.loading(),
const LoadState.data(['A', 'B']),
const LoadState.error('timeout'),
];
for (final state in states) {
print(describe(state));
}
}DataState(:final items) 既完成“这是数据分支”的判断,也把 items 解构为当前 case 内可用的局部变量。整个 switch 不需要 as 强制转换,也不需要先访问一个额外的枚举字段。
生成并运行示例
先生成 Freezed 代码。
dart run build_runner build --delete-conflicting-outputs预期结果:
生成或更新 lib/switch_demo.freezed.dart,命令正常结束,退出码为 0。再运行程序。
dart run lib/switch_demo.dart预期输出:
加载中
共 2 条
失败:timeout让新增分支主动暴露遗漏
穷尽性检查的价值在于维护阶段。片段示例:在同一个 LoadState 联合类型中新增一个空数据分支,其他代码保持不变。
const factory LoadState.empty() = EmptyState;此片段依赖前面的 LoadState 定义,不能单独运行。新增后执行静态分析:
dart analyze预期结果:
分析失败;原有 switch 不再穷尽,缺少对 EmptyState 的处理。具体诊断文案可能随 Dart 版本不同。此时应该补上 EmptyState() 的 case,而不是为了让分析通过直接加 _ => ...。通配分支会吞掉今后新增的所有类型,从而失去“新增联合分支时提醒维护消费端”的能力。
什么时候使用默认分支
当联合类型是你自己维护、分支集合应该封闭时,优先写全所有 case,不加默认分支。这样状态机、页面渲染、错误处理等逻辑都会随着模型演进获得编译器保护。
只有当输入类型本来就是开放集合,或者业务明确需要把未来未知类型统一降级处理时,才使用 _。对于 Freezed 的 sealed 联合类型,穷尽 switch 通常比手写 if 链更短,也更能表达“每个合法分支都必须被处理”的约束。