跳到正文
CH 11工程化Flutter8 分钟阅读

状态管理:从 setState 到 InheritedWidget 再到 Riverpod

第 11 章 · 状态管理:从 setState 到 InheritedWidget 再到 Riverpod

本章示例examples/ch11-state-management在线阅读源码下载 zip

run

$cd examples/ch11-state-management && flutter run -d macos

已验证

  • flutter analyze 0 告警、flutter test 11 个用例全绿、flutter build macos --debug 真实构建并启动成功
  • 完整工程已打包:打包下载
本章目录 · 18 节

11.1 本章目标

  • 看清 setState 的边界:它只管"一个页面自己的状态";
  • 理解 InheritedWidget 的机制(依赖订阅 + 沿树查找),知道 Theme.of 为什么能工作;
  • 会用 ChangeNotifier + ListenableBuilder 写可复用模型,也知道它的三个局限;
  • 掌握 Riverpod:ProviderScope、Notifier、ConsumerWidget、ref.watch / ref.read、派生 provider、family、overrideWith;
  • 知道每一层"为什么需要下一层",而不是背 API。

这是综合项目(ch16/ch17)的基石。示例把四种方式放在同一个应用里并排演示,测试分别覆盖。

11.2 状态管理要解决的问题

一句话:状态的归属与传播。

问题 setState 的答案
状态属于谁? 当前 State
谁能读? 自己 + 通过构造参数传下去的子级
谁能改? 自己
别的页面怎么读? 传不下去,只能放全局变量

三个典型痛点:

  1. 跨页面共享(购物车、登录用户、主题)→ 需要把状态提到 State 之上;
  2. 跨层传递(第 5 层组件要用顶层数据)→ 需要"沿树查找",即 InheritedWidget;
  3. 测试替身(测试里想要一个预置数据的购物车)→ 需要"依赖可替换",即 Riverpod 的 override。

11.3 层次 1:setState(复习 ch06)

dart
int _count = 0;
void _bump() => setState(() => _count++);

能用,但只适合"叶子页面"。一旦两个页面要看同一份数据,这套就崩了——你要么把状态提到最近公共祖先,然后逐层传参("prop drilling"),要么上全局变量。前者代码爆炸,后者不可测。

11.4 层次 2:InheritedWidget(框架原生机制)

dartlib/src/inherited_counter.dart源文件
// examples/ch11-state-management/lib/src/inherited_counter.dart
class CounterScope extends InheritedNotifier<ValueNotifier<int>> {
  const CounterScope({super.key, required ValueNotifier<int> counter, required super.child})
      : super(notifier: counter);

  static ValueNotifier<int> of(BuildContext context) {
    final CounterScope? scope = context.dependOnInheritedWidgetOfExactType<CounterScope>();
    assert(scope != null, 'CounterScope 不在祖先链上');
    return scope!.notifier!;
  }
}

用法(两个互不相干的兄弟组件):

dart
class _CounterLabel extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final ValueNotifier<int> counter = CounterScope.of(context);
    return Text('count = ${counter.value}');
  }
}

机制拆解:

步骤 发生什么
祖先放数据 CounterScope 挂在树上,携带 ValueNotifier
后代 of(context) dependOnInheritedWidgetOfExactType 沿树向上找最近的 Scope
注册依赖 找到的同时,把当前 Element 注册为依赖者
数据变化 InheritedNotifier 监听 notifier → 通知所有依赖者重建
只重建依赖者 没调用 of() 的兄弟组件不会重建

这就是 Theme.of(context)、MediaQuery.of(context) 的全部原理。ch09 的 ThemeExtension 也是沿这条链查的。

三个局限

  1. 必须挂在 Widget 树里:想在 initState/纯 Dart 逻辑里读状态?只能拿到 context 再查,或者把值传进去。
  2. 样板代码多:每个共享状态都要写一个 XxxScope + of() + 找地方创建/销毁 notifier。
  3. 不好测试:要测一个依赖 Scope 的组件,必须搭出整条祖先链。

InheritedWidget 是"机制",不是"方案"。生产里几乎没人手写它——Riverpod 内部就是拿它做的(UncontrolledProviderScope)。

11.5 层次 3:ChangeNotifier + ListenableBuilder

dartlib/src/change_notifier_cart.dart源文件
// examples/ch11-state-management/lib/src/change_notifier_cart.dart
class CartModel extends ChangeNotifier {
  final List<CartItem> _items = <CartItem>[];

  List<CartItem> get items => List<CartItem>.unmodifiable(_items);
  int get totalCents => _items.fold(0, (sum, i) => sum + i.subtotalCents);

  void add(CartItem item) {
    _items.add(item);
    notifyListeners();          // ← 通知所有监听者
  }
  void removeAt(int index) { _items.removeAt(index); notifyListeners(); }
}
dart
ListenableBuilder(
  listenable: _model,
  builder: (BuildContext context, Widget? child) {
    return Text('共 ${_model.items.length} 件,合计 ¥${...}');
  },
)
项 说明
notifyListeners() 手动触发。漏掉它就是"状态变了 UI 不动"
ListenableBuilder 只重建 builder 内部,比 setState 精准
dispose() ChangeNotifier 也是资源,必须释放(ch06 的规矩)
模型层 纯 Dart,不依赖 BuildContext,可以单测

三个局限:

  1. 传递问题没解决:_model 还是要创建在某个 State 里,别的页面要用就得传或再套 InheritedWidget;
  2. 通知是整块的:notifyListeners() 会让所有监听者重建,无法"只关心商品数量";
  3. 测试替身难:没有内置的"把这个模型换成假的"机制。

provider 包(ChangeNotifierProvider)就是把 InheritedWidget + ChangeNotifier 封起来的产物。Riverpod 是同一作者的下一代替换方案。

11.6 层次 4:Riverpod

三个概念

dartlib/providers.dart源文件
// examples/ch11-state-management/lib/providers.dart
class CartNotifier extends Notifier<List<CartItem>> {
  @override
  List<CartItem> build() => const <CartItem>[];   // 初始状态

  void add(CartItem item) { /* 新建列表赋给 state */ }
  void removeAt(int index) => state = <CartItem>[...state]..removeAt(index);
  void clear() => state = const <CartItem>[];
}

/// 可写状态
final cartProvider = NotifierProvider<CartNotifier, List<CartItem>>(CartNotifier.new);

/// 派生(只读)状态:自动随 cartProvider 重算
final cartTotalProvider = Provider<int>((Ref ref) {
  final List<CartItem> items = ref.watch(cartProvider);
  return items.fold(0, (int sum, CartItem i) => sum + i.subtotalCents);
});

/// 带参数的 provider:每个 sku 一个独立缓存槽
final quantityProvider = Provider.family<int, String>((Ref ref, String sku) {
  final List<CartItem> items = ref.watch(cartProvider);
  return items.where((CartItem i) => i.sku == sku).fold(0, (int sum, CartItem i) => sum + i.quantity);
});
概念 作用 类比
ProviderScope 状态容器根,runApp 外层必须有一个 进程级的"状态服务"
Notifier 可写状态 + 操作方法 带通知的模型
Provider 只读/派生值,自动缓存 自动失效的 getter
Provider.family 按参数区分的 provider 带 key 的缓存
ref.watch(p) 订阅,变化就重建 dependOnInheritedWidgetOfExactType
ref.read(p) 只读一次,不订阅 事件回调里用
overrideWith 替换实现(测试/DI) 依赖注入

不可变更新是硬要求

dart
// ✅ 新建列表 → state 指向新对象 → Riverpod 发现"变了"
state = <CartItem>[...state, item];

// ❌ 原地 add → 列表还是同一个对象(identical)→ 不通知
state.add(item);

Riverpod 用 identical 判断状态是否变化(Notifier 的默认相等性),所以不要原地修改。模型类用 final 字段 + copyWith,这也是 ch03 值语义的延续。

ref.watch vs ref.read

位置 用哪个 原因
build() 里 watch 需要订阅,值变要重建
按钮 onPressed 里 read 一次性读取;watch 在事件里没意义
initState 里 read 此时不能 watch(Riverpod 会警告)
派生 provider 内部 watch 依赖上游
只在回调里写状态 read(p.notifier) 只要 notifier,不要值

示例里的写法:

dart
onPressed: () => ref.read(cartProvider.notifier).add(item),

ConsumerWidget 与局部重建

ConsumerWidget 的整个 build 都会响应 watch。想缩小重建范围,就用 Consumer 包一小块:

dart
Consumer(
  builder: (BuildContext context, WidgetRef ref, Widget? child) {
    final int total = ref.watch(cartTotalProvider);
    return Text('¥${(total / 100).toStringAsFixed(2)}');
  },
)

child 参数可以传入不随状态变化的子树(和 AnimatedBuilder.child 一个套路)。

跨页面共享:不需要任何参数

dart
class CartDetailPage extends ConsumerWidget {
  const CartDetailPage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final List<CartItem> items = ref.watch(cartProvider);
    final int total = ref.watch(cartTotalProvider);
    ...
  }
}

详情页和首页读同一个 cartProvider,谁改了另一个页面立刻同步——测试里断言了这一点(详情页加购 → 返回首页总价变成 ¥176.00)。

overrideWith:依赖注入 + 测试替身

dart
class SeededCart extends CartNotifier {
  @override
  List<CartItem> build() => <CartItem>[catalog.first];
}

await tester.pumpWidget(
  ProviderScope(
    overrides: [cartProvider.overrideWith(SeededCart.new)],
    child: const StateApp(),
  ),
);
// 一启动就已经有一件商品
expect(find.text('共 1 件,合计 ¥88.00'), findsOneWidget);

生产代码里同样有用:把"真实 API 客户端"换成"本地 mock"(ch13),把"真实时钟"换成"固定时间"。这也是 Riverpod 相对 ChangeNotifier 最大的工程价值。

无 Widget 单测

dart
final ProviderContainer container = ProviderContainer();
addTearDown(container.dispose);

container.read(cartProvider.notifier).add(catalog[0]);
expect(container.read(cartTotalProvider), 8800);
expect(container.read(quantityProvider('coffee')), 1);

不需要 BuildContext、不需要 pumpWidget。状态逻辑的测试成本从"搭一棵树"降到"读一个值"。

11.7 该用哪一层

场景 选择
一个页面内的临时 UI 状态(展开/收起、输入草稿) setState / ValueNotifier
一个页面的复杂模型(表单、列表编辑) ChangeNotifier 或本地 Notifier(Riverpod)
跨页面共享(用户、购物车、主题) Riverpod
需要派生计算(总价、过滤后的列表) Riverpod Provider
需要异步状态(loading/error/data) Riverpod AsyncNotifier(ch13)
大型项目、多人协作 Riverpod(可测试、可覆盖、无全局单例)

本项目从 ch13 起统一用 Riverpod(AGENTS.md §8 的要求),综合项目 ch16/ch17 也以它为主。

对照其他生态:Riverpod ≈ Go 里"显式注入的依赖容器 + 可监听的服务",但类型安全、无反射、无 init() 全局单例;也 ≈ Redux,但没有 action/reducer 的样板。

11.8 运行与验证

bash
cd examples/ch11-state-management
flutter pub get && flutter analyze && flutter test
flutter run -d macos

本次真实验证:

text
No issues found! (ran in 3.3s)
00:00 +11: All tests passed!

✓ Built build/macos/Build/Products/Debug/ch11_state_management.app
flutter: The Dart VM service is listening on http://127.0.0.1:61137/...

界面上三个区块分别演示三种机制;点"打开详情页"能看到 Riverpod 的跨页面共享。

附:C/Go 代码对照:接口注入

go
// Go:构造函数注入接口,测试时换成 fake
type BookmarkRepo interface {
    WatchAll(ctx context.Context) (<-chan Bookmark, error)
}

type Service struct{ repo BookmarkRepo }

func NewService(repo BookmarkRepo) *Service { return &Service{repo: repo} }

// 测试
svc := NewService(fakeRepo{items: []Bookmark{{ID: 1}}})
dart
// Riverpod:同样的"依赖抽象 + 注入实现",只是发生在容器里
final repositoryProvider = Provider<BookmarkRepository>(
  (ref) => DriftBookmarkRepository(ref.watch(databaseProvider), ref.watch(remoteApiProvider)),
);

// 测试
ProviderScope(
  overrides: [repositoryProvider.overrideWithValue(FakeRepository())],
  child: const App(),
);

Go 靠"传参"注入,Riverpod 靠"覆盖 provider"注入;效果一样:业务代码只依赖 BookmarkRepository 接口,换实现不改调用点。

11.9 本章小结 + C/Go 对照清单

主题 Go / C 里的对应做法 Flutter/Dart 陷阱
页面内状态 结构体成员 State + setState build 里改状态
沿树传值 逐层传参 / 全局变量 InheritedWidget 手写样板多、难测
可监听模型 自己写 listener 列表 ChangeNotifier + ListenableBuilder 漏 notifyListeners
全局状态 init() 单例 / 全局变量 Riverpod provider 原地改状态不通知
依赖注入 构造函数注入 / 接口 overrideWith + ProviderScope 忘了包 ProviderScope
派生值 每次调用重算 Provider(自动缓存) 在 build 里做重计算
并发安全 mutex 单线程,不需要 但 isolate 间不能共享状态

给 C/Go 老兵的三句话:

  1. InheritedWidget 是机制(沿树查找 + 订阅),Riverpod 是它的产品化封装;不要在生产里手写前者。
  2. 不可变更新是 Riverpod 的地基:改状态 = 换一个新对象,而不是原地修改。
  3. overrideWith 就是 Go 的接口替换、C 的函数指针替换——有了它,状态层才可测。

下一章是重点章节:JSON 编解码。从 dart:convert 到 json_serializable 代码生成,再到健壮的错误处理,并密集对照 Go 的 encoding/json 与 C 的 cJSON。