如何在Riverpod中高效更新对象状态并维护复杂状态？

方案1：给状态类添加copyWith方法 #

这是无额外依赖的基础方案，手动给状态类实现copyWith方法，快速生成新实例并仅修改目标属性：

class CounterState {
  int value;
  bool isCompleted;
  String? statusText;
  double? progress;
  // 可继续添加更多属性

  CounterState({
    this.value = 0,
    this.isCompleted = false,
    this.statusText,
    this.progress,
  });

  // 实现copyWith，用可选参数覆盖原属性，未传参则保留原值
  CounterState copyWith({
    int? value,
    bool? isCompleted,
    String? statusText,
    double? progress,
  }) {
    return CounterState(
      value: value ?? this.value,
      isCompleted: isCompleted ?? this.isCompleted,
      statusText: statusText ?? this.statusText,
      progress: progress ?? this.progress,
    );
  }
}

在Provider中使用就会非常简洁：

@riverpod
class CounterProvider extends _$CounterProvider {
  @override
  CounterState build() {
    return CounterState();
  }

  void setValue(int newValue) {
    // 仅更新value，其余属性保留原样
    state = state.copyWith(value: newValue);
    if (newValue == 1) {
      // 仅更新isCompleted属性
      state = state.copyWith(isCompleted: true);
    }
  }

  void updateProgress(double newProgress) {
    state = state.copyWith(progress: newProgress);
  }
}

方案2：用freezed自动生成不可变类与copyWith #

如果状态属性超过10个，手动写copyWith太繁琐，可借助freezed包自动生成所有样板代码，同时强制状态不可变（从根源避免直接修改属性的错误）：

1. 添加依赖到pubspec.yaml：

dependencies:
  freezed_annotation: ^2.4.1

dev_dependencies:
  build_runner: ^2.4.8
  freezed: ^2.4.7

2. 用注解定义状态类：

import 'package:freezed_annotation/freezed_annotation.dart';

part 'counter_state.freezed.dart';

@freezed
class CounterState with _$CounterState {
  const factory CounterState({
    @Default(0) int value,
    @Default(false) bool isCompleted,
    String? statusText,
    double? progress,
    // 可继续添加任意数量属性
  }) = _CounterState;
}

3. 运行命令生成代码：

flutter pub run build_runner build

4. 在Provider中使用生成的copyWith：

@riverpod
class CounterProvider extends _$CounterProvider {
  @override
  CounterState build() {
    return const CounterState();
  }

  void setValue(int newValue) {
    state = state.copyWith(value: newValue);
    if (newValue == 1) {
      state = state.copyWith(isCompleted: true);
    }
  }
}

freezed还会自动生成toString、==、hashCode等实用方法，同时保证状态属性为final，彻底杜绝直接修改属性的操作。

方案3：拆分独立状态（按需使用） #

如果状态内的属性可划分为独立逻辑模块，比如把进度、状态文本和计数器核心逻辑分离，可以拆成多个独立Provider：

// 核心计数器值
@riverpod
class CounterValue extends _$CounterValue {
  @override
  int build() => 0;

  void setValue(int newValue) => state = newValue;
}

// 完成状态标记
@riverpod
class CounterCompleted extends _$CounterCompleted {
  @override
  bool build() => false;

  void setCompleted(bool value) => state = value;
}

这种方式适合属性关联性弱的场景，让每个Provider职责更单一，但如果属性必须联动变化，就不建议拆分。

内容的提问来源于stack exchange，提问作者Tuan Nguyen