Riverpod中state值应放置何处？两种watch写法的差异解析

两种写法的来源场景 #

• 写法1：文档中出现的int count = watch(counterProvider).state;
  该写法是Riverpod早期0.x预览版、1.0正式版之前的标准用法，核心是watch(provider)的返回值为状态容器实例，需要额外读取实例上的.state属性才能拿到真实状态值。
• 写法2：实际能跑通的watch(myNotifier.state)
  该写法不属于官方推荐的标准实现，能运行往往是版本错位、引用对象混淆带来的偶然结果。

两种写法的核心差异 #

• 返回值逻辑的版本适配差异

  在Riverpod 1.0之前的版本中，没有为Provider添加语法糖封装：传入StateProvider给watch会返回StateController实例，传入StateNotifierProvider给watch会返回自定义的StateNotifier子类实例，这两个容器实例内部维护的实际状态，都需要通过读取.state属性获取，因此才会出现watch(xxxProvider).state的写法。
  到了1.0及之后的稳定版本，Riverpod对Provider的返回值做了语法糖封装：watch(StateProvider)、watch(StateNotifierProvider)会直接返回当前最新的状态值，不再需要手动读取.state；如果需要拿到对应的状态容器实例，反而需要通过watch(xxxProvider.notifier)的方式获取。

• 依赖追踪的生效范围差异
  能正常运行的watch(myNotifier.state)写法，实际引用的对象根本不是Provider本身：
  • 这里的myNotifier一般是已经通过Provider挂载完成的StateNotifier实例，直接读取它的.state属性，本质是手动访问了StateNotifier内部的状态存储，不会将这个状态的变化注册到组件的监听依赖列表中
  • 这种写法虽然能读到初始状态值，但当状态发生变化时，组件根本不会收到重建通知，会出现UI不随状态更新的问题。

不同版本下的正确使用姿势 #

• Riverpod 2.x 稳定版
  • 读取StateProvider状态：直接写final count = watch(counterProvider);即可，手动追加.state会直接触发类型不匹配报错
  • 读取StateNotifierProvider状态：直接写final userInfo = watch(userStateNotifierProvider);，即可拿到当前最新的状态值
  • 需要拿到StateNotifier实例调用修改方法时：使用final notifier = watch(userStateNotifierProvider.notifier);
• Riverpod 1.0 之前的旧版本
  • 读取状态的写法与早期文档一致：final count = watch(counterProvider).state;
  • 该写法因为缺少统一的语法糖约束，很容易出现读取值不更新、类型推导错误的问题，也是官方后续迭代彻底替换这套逻辑的核心原因。

内容的提问来源于stack exchange，提问作者joe kletz