跨平台开发 / 系统课时
让 Provider 依赖另一个 Provider
让 Provider 依赖另一个 Provider
本篇学习 Riverpod 中 Provider 之间的组合方式,通过 ref.watch 建立依赖链,让一个 Provider 根据另一个 Provider 的变化自动重新计算派生结果。
学习目标
- 理解 Provider 之间依赖关系的表达方式。
- 掌握在 Provider 内部使用
ref.watch获取其他 Provider。 - 能设计简单的派生依赖结构。
Provider 组合解决什么问题
实际应用中,一个依赖通常不会独立存在。例如用户信息需要依赖 API 仓库,格式化显示名称可能又依赖用户信息。如果每个地方都重复创建这些逻辑,代码会逐渐失去统一入口。
Riverpod 允许 Provider 读取其他 Provider,从而形成依赖链。当上游依赖发生变化时,下游 Provider 会自动失效并重新计算。

使用 ref.watch 建立依赖
下面示例中,用户名称 Provider 依赖用户仓库 Provider。
import 'package:flutter_riverpod/flutter_riverpod.dart';
class UserRepository {
String fetchName() {
return 'Riverpod User';
}
}
final userRepositoryProvider = Provider<UserRepository>((ref) {
return UserRepository();
});
final userNameProvider = Provider<String>((ref) {
final repository = ref.watch(userRepositoryProvider);
return repository.fetchName();
});
void main() {
final container = ProviderContainer();
final name = container.read(userNameProvider);
print(name);
container.dispose();
}预期输出
Riverpod Userref.watch 表示当前 Provider 声明了依赖关系。Riverpod 会记录这种关系,并在依赖变化时重新执行当前 Provider。
watch 与 read 的区别
在 Provider 内部获取其他 Provider 时,通常应该使用 ref.watch,因为它能够建立响应式关系。
| 方法 | 作用 | 是否建立依赖 |
|---|---|---|
| ref.watch | 读取并监听变化 | 是 |
| ref.read | 单次读取当前值 | 否 |
如果只是执行一次动作,例如按钮点击时调用仓库方法,可以使用 ref.read。如果计算结果需要随着依赖变化自动更新,则必须使用 ref.watch。
创建派生状态
Provider 组合最常见的用途是创建派生状态。派生状态不是独立保存的数据,而是根据已有数据计算得到的结果。
例如根据用户设置生成显示文本:
import 'package:flutter_riverpod/flutter_riverpod.dart';
final languageProvider = Provider<String>((ref) {
return 'zh-CN';
});
final localeTextProvider = Provider<String>((ref) {
final language = ref.watch(languageProvider);
if (language == 'zh-CN') {
return '中文模式';
}
return 'English Mode';
});预期结果
当 languageProvider 返回 zh-CN 时,localeTextProvider 返回 中文模式。这种方式避免保存重复状态。例如不需要同时维护 language 和 localeText 两份数据,只保存源数据即可。
设计 Provider 依赖时的注意点
Provider 组合应该保持单向依赖。底层服务可以被上层业务 Provider 使用,但基础 Provider 不应该反过来依赖页面状态,否则容易形成复杂的循环关系。
常见结构是:
- 基础 Provider:提供服务和配置。
- 业务 Provider:组合多个基础依赖,生成业务数据。
- Widget:读取最终结果并展示。
当一个 Provider 只是另一个值的简单转换时,优先使用 Provider 组合,而不是复制数据或手动同步状态。这样可以让状态来源保持唯一,减少更新遗漏的问题。