跨平台开发 / 系统课时

用不可变对象保存复杂状态

用不可变对象保存复杂状态

当一个页面同时维护名称、积分、标签等多个字段时,直接修改同一个对象很容易让状态变化变得隐蔽。更稳妥的做法是让状态对象保持不可变,每次修改都通过 copyWith 创建新对象,再把新对象交给 Riverpod 的 Notifier。

学习目标

  • 理解为什么复杂业务状态应优先使用不可变对象
  • 能为状态类实现 copyWith 并通过 Notifier 替换状态
  • 能避免集合字段被外部引用继续修改的问题

为什么不要原地修改状态对象

假设用户资料同时包含名称、积分和标签。若这些字段可以被任意代码直接改写,调用方可能持有同一个对象引用,某处修改后,其他位置看到的数据也会悄然变化。这样的修改没有明确的“旧状态 → 新状态”边界,调试和测试都会变困难。

不可变状态的核心规则很简单:对象创建后不再修改已有字段。业务操作根据旧状态计算一个新对象,然后执行 state = 新对象。这样每次状态变化都有清晰的新旧实例边界,也更符合 Riverpod 根据状态赋值通知监听者的使用方式。

用 copyWith 创建新状态

下面用一个完整示例管理用户资料。状态类的字段全部声明为 final,copyWith 只替换调用者明确提供的字段,其余字段沿用旧值。

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

class UserProfileState {
  const UserProfileState({
    required this.name,
    required this.points,
    required this.tags,
  });

  final String name;
  final int points;
  final List<String> tags;

  UserProfileState copyWith({
    String? name,
    int? points,
    List<String>? tags,
  }) {
    return UserProfileState(
      name: name ?? this.name,
      points: points ?? this.points,
      tags: tags ?? this.tags,
    );
  }

  @override
  String toString() =>
      'UserProfileState(name: $name, points: $points, tags: $tags)';
}

class UserProfileNotifier extends Notifier<UserProfileState> {
  @override
  UserProfileState build() {
    return const UserProfileState(
      name: 'Alice',
      points: 0,
      tags: [],
    );
  }

  void addPoints(int value) {
    state = state.copyWith(points: state.points + value);
  }

  void addTag(String tag) {
    // 同时创建新的 List,避免复用旧集合后再进行原地修改。
    state = state.copyWith(tags: [...state.tags, tag]);
  }
}

final userProfileProvider =
    NotifierProvider<UserProfileNotifier, UserProfileState>(
  UserProfileNotifier.new,
);

void main() {
  final container = ProviderContainer();

  print('初始: ${container.read(userProfileProvider)}');

  final notifier = container.read(userProfileProvider.notifier);
  notifier.addPoints(10);
  notifier.addTag('vip');

  print('更新后: ${container.read(userProfileProvider)}');
  container.dispose();
}

预期输出

text
初始: UserProfileState(name: Alice, points: 0, tags: [])
更新后: UserProfileState(name: Alice, points: 10, tags: [vip])

这里真正重要的不是 copyWith 这个方法名,而是每次操作都产生一个新的 UserProfileState。addPoints 没有执行 state.points += 10,addTag 也没有对旧列表调用 add,而是构造新的值后整体替换 state。

集合字段也要保持不可变更新

对象字段是 final 并不意味着内部集合自动不可变。final List<String> 只能保证变量不能重新指向另一份列表,却仍可能对列表本身调用 add、remove 等方法。

因此更新集合字段时,应创建新集合,例如 [...state.tags, tag]。如果状态对象还会暴露给业务层之外的代码,并且需要更严格地阻止外部修改,还可以在构造阶段保存不可修改视图或使用专门的不可变集合类型。

copyWith 的一个重要边界

上面的 copyWith 使用 name ?? this.name 这类写法,因此适用于字段本身不需要保存 null 的场景。如果某个字段声明为可空类型,并且业务需要明确地把它更新为 null,就需要使用额外哨兵值、专门参数或代码生成方案来区分“没有传参”和“主动设置为 null”。

对于字段数量较少的状态,手写 copyWith 足够直接;字段越来越多时,可以考虑使用支持不可变模型与代码生成的工具减少样板代码。无论采用哪种实现方式,关键约束都不变:读取旧状态、创建新值、一次性替换 state,不要让业务逻辑依赖共享可变对象。

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

目录与阅读设置

阅读设置

17

记录一个想法

用不可变对象保存复杂状态

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

登录哪都通