跨平台开发 / 系统课时

用 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,新的返回值再参与界面渲染。

ref.watch 触发 Widget 重建流程

watch 最适合放在 build 或 Provider 的创建逻辑中,因为这些位置需要声明响应式依赖。按钮点击、提交表单这类一次性事件通常不需要让回调本身持续订阅状态,应使用 ref.read 获取控制器后执行动作。

用计数器验证自动重建

下面使用 NotifierProvider 保存计数器状态。界面通过 ref.watch(counterProvider) 读取当前值;按钮点击时用 ref.read(counterProvider.notifier) 调用修改方法。状态改变后,不需要手动调用 setState。

dart
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),
      ),
    );
  }
}

预期结果

text
应用首次打开:
计数: 0

每点击一次 + 按钮:
计数值增加 1,例如 0 -> 1 -> 2

这里真正触发响应式更新的是 ref.watch(counterProvider) 建立的订阅;increment() 只是修改 Provider 状态。如果把界面中的 watch 换成 read,当前 build 只会取得当时的值,不会因为后续状态变化而自动重新构建。

把 watch 放在最小消费范围

ref.watch 会让调用它的消费者在依赖变化时重新构建,所以消费范围越精确,更新成本越可控。页面只有一小块文字依赖计数时,可以把这部分拆成独立 ConsumerWidget,而不是让整个复杂页面都监听同一状态。

当 Provider 暴露的是复杂对象时,还可以只监听界面真正需要的部分,避免无关字段变化导致额外重建。原则不是“少用 watch”,而是让依赖关系与 UI 的实际刷新边界一致。

当界面需要随着 Provider 值变化而更新时,优先让 ref.watch 明确表达依赖,而不是在业务代码里自行维护监听器或调用 setState 同步两套状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ref.watch 响应状态变化

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

登录哪都通