跨平台开发 / 系统课时
用 ref.watch 响应状态变化
用 ref.watch 响应状态变化
ref.watch 用来在构建阶段声明“这个 Widget 依赖哪个 Provider”。当被监听的状态变化时,Riverpod 会让相关消费者重新构建,从而把最新状态反映到界面;不依赖该 Provider 的 Widget 不需要因此整体刷新。
学习目标
- 在
ConsumerWidget中使用ref.watch订阅 Provider - 理解状态变化到 Widget 重建之间的触发链路
- 区分构建期的
watch与事件处理中的read
watch 会建立响应式依赖
调用 ref.watch(counterProvider) 不只是“读一次值”。它同时把当前消费者登记为 counterProvider 的依赖者。Provider 的状态改变后,Riverpod 根据这条依赖关系通知消费者重新执行 build,新的返回值再参与界面渲染。

watch 最适合放在 build 或 Provider 的创建逻辑中,因为这些位置需要声明响应式依赖。按钮点击、提交表单这类一次性事件通常不需要让回调本身持续订阅状态,应使用 ref.read 获取控制器后执行动作。
用计数器验证自动重建
下面使用 NotifierProvider 保存计数器状态。界面通过 ref.watch(counterProvider) 读取当前值;按钮点击时用 ref.read(counterProvider.notifier) 调用修改方法。状态改变后,不需要手动调用 setState。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
class Counter extends Notifier<int> {
@override
int build() => 0;
void increment() {
state++;
}
}
final counterProvider = NotifierProvider<Counter, int>(Counter.new);
void main() {
runApp(
const ProviderScope(
child: MaterialApp(home: CounterPage()),
),
);
}
class CounterPage extends ConsumerWidget {
const CounterPage({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final count = ref.watch(counterProvider);
return Scaffold(
body: Center(
child: Text('计数: $count'),
),
floatingActionButton: FloatingActionButton(
onPressed: () {
ref.read(counterProvider.notifier).increment();
},
child: const Icon(Icons.add),
),
);
}
}预期结果
应用首次打开:
计数: 0
每点击一次 + 按钮:
计数值增加 1,例如 0 -> 1 -> 2这里真正触发响应式更新的是 ref.watch(counterProvider) 建立的订阅;increment() 只是修改 Provider 状态。如果把界面中的 watch 换成 read,当前 build 只会取得当时的值,不会因为后续状态变化而自动重新构建。
把 watch 放在最小消费范围
ref.watch 会让调用它的消费者在依赖变化时重新构建,所以消费范围越精确,更新成本越可控。页面只有一小块文字依赖计数时,可以把这部分拆成独立 ConsumerWidget,而不是让整个复杂页面都监听同一状态。
当 Provider 暴露的是复杂对象时,还可以只监听界面真正需要的部分,避免无关字段变化导致额外重建。原则不是“少用 watch”,而是让依赖关系与 UI 的实际刷新边界一致。
当界面需要随着 Provider 值变化而更新时,优先让 ref.watch 明确表达依赖,而不是在业务代码里自行维护监听器或调用 setState 同步两套状态。