跨平台开发 / 系统课时
生成相等性与 hashCode
生成相等性与 hashCode
在列表渲染、状态管理和单元测试中,模型是否相等通常应该由字段值决定,而不是由对象是不是同一个实例决定。Freezed 会为不可变模型生成 ==、hashCode 和 toString。本节直接用独立实例验证按值比较,并观察集合字段和可变模型带来的边界。
学习目标
- 验证字段相同的独立 Freezed 实例可以按值判等,并拥有一致的
hashCode。 - 理解
List等集合字段参与深度比较时,元素值和顺序如何影响结果。 - 判断值相等性在集合、状态比较和测试断言中的作用与限制。
用代码观察值相等
先定义一个带集合字段的任务模型。下面是 lib/models/task.dart 的片段示例,项目需要已经安装 freezed_annotation、freezed 和 build_runner。
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;
}生成代码:
dart run build_runner build --delete-conflicting-outputs预期结果
构建命令正常结束,lib/models/task.freezed.dart 已生成。然后创建 lib/main.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);
}执行:
dart run lib/main.dart预期输出
true
true
true
false
2first 与 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 相同的自动值相等行为。需要状态快照、集合去重、缓存键或精确测试断言时,保持不可变模型通常更符合这些场景的比较需求;确实需要可变对象时,则应重新明确对象身份与相等性的规则。