状态管理:从 setState 到 InheritedWidget 再到 Riverpod
第 11 章 · 状态管理:从 setState 到 InheritedWidget 再到 Riverpod
run
$cd examples/ch11-state-management && flutter run -d macos已验证
- flutter analyze 0 告警、flutter test 11 个用例全绿、flutter build macos --debug 真实构建并启动成功
- 完整工程已打包:打包下载
本章目录 · 18 节
- 11.1 本章目标
- 11.2 状态管理要解决的问题
- 11.3 层次 1:setState(复习 ch06)
- 11.4 层次 2:InheritedWidget(框架原生机制)
- 三个局限
- 11.5 层次 3:ChangeNotifier + ListenableBuilder
- 11.6 层次 4:Riverpod
- 三个概念
- 不可变更新是硬要求
- ref.watch vs ref.read
- ConsumerWidget 与局部重建
- 跨页面共享:不需要任何参数
- overrideWith:依赖注入 + 测试替身
- 无 Widget 单测
- 11.7 该用哪一层
- 11.8 运行与验证
- 附:C/Go 代码对照:接口注入
- 11.9 本章小结 + C/Go 对照清单
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 |
| 谁能读? | 自己 + 通过构造参数传下去的子级 |
| 谁能改? | 自己 |
| 别的页面怎么读? | 传不下去,只能放全局变量 |
三个典型痛点:
- 跨页面共享(购物车、登录用户、主题)→ 需要把状态提到
State之上; - 跨层传递(第 5 层组件要用顶层数据)→ 需要"沿树查找",即
InheritedWidget; - 测试替身(测试里想要一个预置数据的购物车)→ 需要"依赖可替换",即 Riverpod 的 override。
11.3 层次 1:setState(复习 ch06)
int _count = 0;
void _bump() => setState(() => _count++);
能用,但只适合"叶子页面"。一旦两个页面要看同一份数据,这套就崩了——你要么把状态提到最近公共祖先,然后逐层传参("prop drilling"),要么上全局变量。前者代码爆炸,后者不可测。
11.4 层次 2:InheritedWidget(框架原生机制)
// 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!;
}
}
用法(两个互不相干的兄弟组件):
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 也是沿这条链查的。
三个局限
- 必须挂在 Widget 树里:想在
initState/纯 Dart 逻辑里读状态?只能拿到context再查,或者把值传进去。 - 样板代码多:每个共享状态都要写一个
XxxScope+of()+ 找地方创建/销毁 notifier。 - 不好测试:要测一个依赖 Scope 的组件,必须搭出整条祖先链。
InheritedWidget 是"机制",不是"方案"。生产里几乎没人手写它——Riverpod 内部就是拿它做的(UncontrolledProviderScope)。
11.5 层次 3:ChangeNotifier + ListenableBuilder
// 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(); }
}
ListenableBuilder(
listenable: _model,
builder: (BuildContext context, Widget? child) {
return Text('共 ${_model.items.length} 件,合计 ¥${...}');
},
)
| 项 | 说明 |
|---|---|
notifyListeners() |
手动触发。漏掉它就是"状态变了 UI 不动" |
ListenableBuilder |
只重建 builder 内部,比 setState 精准 |
dispose() |
ChangeNotifier 也是资源,必须释放(ch06 的规矩) |
| 模型层 | 纯 Dart,不依赖 BuildContext,可以单测 |
三个局限:
- 传递问题没解决:
_model还是要创建在某个State里,别的页面要用就得传或再套InheritedWidget; - 通知是整块的:
notifyListeners()会让所有监听者重建,无法"只关心商品数量"; - 测试替身难:没有内置的"把这个模型换成假的"机制。
provider 包(ChangeNotifierProvider)就是把 InheritedWidget + ChangeNotifier 封起来的产物。Riverpod 是同一作者的下一代替换方案。
11.6 层次 4:Riverpod
三个概念
// 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) | 依赖注入 |
不可变更新是硬要求
// ✅ 新建列表 → 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,不要值 |
示例里的写法:
onPressed: () => ref.read(cartProvider.notifier).add(item),
ConsumerWidget 与局部重建
ConsumerWidget 的整个 build 都会响应 watch。想缩小重建范围,就用 Consumer 包一小块:
Consumer(
builder: (BuildContext context, WidgetRef ref, Widget? child) {
final int total = ref.watch(cartTotalProvider);
return Text('¥${(total / 100).toStringAsFixed(2)}');
},
)
child 参数可以传入不随状态变化的子树(和 AnimatedBuilder.child 一个套路)。
跨页面共享:不需要任何参数
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:依赖注入 + 测试替身
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 单测
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 运行与验证
cd examples/ch11-state-management
flutter pub get && flutter analyze && flutter test
flutter run -d macos
本次真实验证:
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:构造函数注入接口,测试时换成 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}}})
// 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 老兵的三句话:
InheritedWidget是机制(沿树查找 + 订阅),Riverpod 是它的产品化封装;不要在生产里手写前者。- 不可变更新是 Riverpod 的地基:改状态 = 换一个新对象,而不是原地修改。
overrideWith就是 Go 的接口替换、C 的函数指针替换——有了它,状态层才可测。
下一章是重点章节:JSON 编解码。从 dart:convert 到 json_serializable 代码生成,再到健壮的错误处理,并密集对照 Go 的 encoding/json 与 C 的 cJSON。