跨平台开发 / 系统课时

用 switch 匹配联合分支

用 switch 匹配联合分支

Freezed 联合类型只有在消费端能安全区分分支时才真正有价值。本节使用 Dart 3 的 switch 与对象模式直接解构不同分支,并利用 sealed 类型的穷尽性检查,让新增分支时遗漏的业务逻辑在编译阶段暴露。

学习目标

  • 用对象模式匹配 Freezed 联合类型的具体分支
  • 在匹配时直接提取分支字段,减少强制转换
  • 保留穷尽性检查,让新增分支触发静态错误

用模式代替 runtimeType 判断

不要先读取 runtimeType 再做字符串或类型比较。对于 sealed 联合类型,直接对对象本身做模式匹配,编译器才能理解“有哪些可能分支”,并在分支不完整时参与检查。

sealed 联合类型与 switch 穷尽性检查关系

下面示例保存为 lib/switch_demo.dart,项目需已配置 freezed_annotation、freezed 与 build_runner。

dart
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 代码。

bash
dart run build_runner build --delete-conflicting-outputs

预期结果:

text
生成或更新 lib/switch_demo.freezed.dart,命令正常结束,退出码为 0。

再运行程序。

bash
dart run lib/switch_demo.dart

预期输出:

text
加载中
共 2 条
失败:timeout

让新增分支主动暴露遗漏

穷尽性检查的价值在于维护阶段。片段示例:在同一个 LoadState 联合类型中新增一个空数据分支,其他代码保持不变。

dart
const factory LoadState.empty() = EmptyState;

此片段依赖前面的 LoadState 定义,不能单独运行。新增后执行静态分析:

bash
dart analyze

预期结果:

text
分析失败;原有 switch 不再穷尽,缺少对 EmptyState 的处理。具体诊断文案可能随 Dart 版本不同。

此时应该补上 EmptyState() 的 case,而不是为了让分析通过直接加 _ => ...。通配分支会吞掉今后新增的所有类型,从而失去“新增联合分支时提醒维护消费端”的能力。

什么时候使用默认分支

当联合类型是你自己维护、分支集合应该封闭时,优先写全所有 case,不加默认分支。这样状态机、页面渲染、错误处理等逻辑都会随着模型演进获得编译器保护。

只有当输入类型本来就是开放集合,或者业务明确需要把未来未知类型统一降级处理时,才使用 _。对于 Freezed 的 sealed 联合类型,穷尽 switch 通常比手写 if 链更短,也更能表达“每个合法分支都必须被处理”的约束。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

用 switch 匹配联合分支

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通