跨平台开发 / 系统课时

生成相等性与 hashCode

生成相等性与 hashCode

在列表渲染、状态管理和单元测试中,模型是否相等通常应该由字段值决定,而不是由对象是不是同一个实例决定。Freezed 会为不可变模型生成 ==、hashCode 和 toString。本节直接用独立实例验证按值比较,并观察集合字段和可变模型带来的边界。

学习目标

  • 验证字段相同的独立 Freezed 实例可以按值判等,并拥有一致的 hashCode。
  • 理解 List 等集合字段参与深度比较时,元素值和顺序如何影响结果。
  • 判断值相等性在集合、状态比较和测试断言中的作用与限制。

用代码观察值相等

先定义一个带集合字段的任务模型。下面是 lib/models/task.dart 的片段示例,项目需要已经安装 freezed_annotation、freezed 和 build_runner。

dart
import 'package:freezed_annotation/freezed_annotation.dart';

part 'task.freezed.dart';

@freezed
abstract class Task with _$Task {
  const factory Task({
    required String id,
    required bool done,
    @Default(<String>[]) List<String> tags,
  }) = _Task;
}

生成代码:

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

预期结果

text
构建命令正常结束,lib/models/task.freezed.dart 已生成。

然后创建 lib/main.dart,分别构造值相同、集合顺序不同以及字段发生变化的对象。

dart
import 'models/task.dart';

void main() {
  const first = Task(
    id: 't-1',
    done: false,
    tags: ['flutter', 'json'],
  );

  const sameValue = Task(
    id: 't-1',
    done: false,
    tags: ['flutter', 'json'],
  );

  const reordered = Task(
    id: 't-1',
    done: false,
    tags: ['json', 'flutter'],
  );

  final completed = first.copyWith(done: true);

  print(first == sameValue);
  print(first.hashCode == sameValue.hashCode);
  print(first.toString().contains('id: t-1'));
  print(first == reordered);
  print({first, sameValue, completed}.length);
}

执行:

bash
dart run lib/main.dart

预期输出

text
true
true
true
false
2

first 与 sameValue 是分别创建的对象,但全部字段值一致,因此 == 为 true。相等对象拥有一致的 hashCode,所以它们进入同一个 Set 时只保留一个;completed 的 done 已改变,因此集合最终包含两个不同值。

集合字段为什么也能比较

普通 Dart List 的相等比较通常不会自动逐元素判断内容,而 Freezed 生成的模型相等逻辑会对集合字段执行深度比较。因此两个不同的列表实例,只要元素值及顺序一致,也可以使整个模型相等。

顺序仍然属于列表的值语义,所以示例里的 ['flutter', 'json'] 与 ['json', 'flutter'] 会让两个 Task 不相等。深度比较最终还依赖元素自己的 ==:如果集合中放的是没有实现值相等语义的普通自定义对象,仅仅内部字段看起来一样,并不保证元素会被判为相等。

在状态、列表和测试里怎么用

值相等让调用方不必重复编写字段比较逻辑。状态管理可以判断新旧状态是否真的变化,测试可以直接比较期望模型和实际模型,Set 或以模型为键的 Map 也可以依赖一致的 == 与 hashCode。

场景 值相等带来的效果
列表或集合去重 字段完全相同的模型可被视为同一个值
状态比较 copyWith 后只有实际字段变化才会与原对象不等
测试断言 可以直接比较完整模型,不必逐字段断言
调试日志 生成的 toString 会展示字段,比默认实例描述更易排查

toString 只适合调试和日志观察,不应被当成稳定的数据交换协议。网络请求、缓存持久化或文件存储仍应使用正式的 JSON 序列化结果,而不是解析 toString 文本。

不可变性与相等性的边界

默认的 @freezed 模型采用不可变语义,对 List、Map、Set 等集合也会提供不可变视图。这能降低对象作为状态快照或集合键之后内容又被修改,从而破坏比较逻辑的风险。

如果业务改用 @unfreezed 来允许字段可变,就不能继续假设它具有与默认 @freezed 相同的自动值相等行为。需要状态快照、集合去重、缓存键或精确测试断言时,保持不可变模型通常更符合这些场景的比较需求;确实需要可变对象时,则应重新明确对象身份与相等性的规则。

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

目录与阅读设置

记录一个想法

生成相等性与 hashCode

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

登录哪都通