跨平台开发 / 系统课时
用 select 缩小重建范围
用 select 缩小重建范围
当一个 Provider 暴露较大的状态对象时,Widget 往往只关心其中一个字段。直接 watch 整个对象会让其他字段变化也触发重建。本节用 select 把订阅范围缩到真正需要的值,并通过日志验证哪些 Widget 被重建,避免把 read 误当成性能优化工具。
学习目标
- 使用
provider.select(...)只订阅状态对象中的指定值 - 通过拆分 Widget 和日志验证重建范围是否真的缩小
- 理解
select的适用边界,避免对可变对象或廉价 Widget 过度优化
select 改变的是订阅结果
默认情况下,ref.watch(userProvider) 订阅的是 Provider 暴露的整个状态。即使当前 Widget 只显示 name,只要 UserState 变成了新的状态值,这个 Widget 就可能参与重建。
select 会先从 Provider 状态中投影出一个更小的值,再只关注这个选择结果是否发生变化。官方文档给出的典型写法就是 ref.watch(userProvider.select((user) => user.name)):年龄等无关字段变化时,名字选择结果不变,因此使用该选择结果的 Widget 不需要重建。([Riverpod][2])
用两个字段验证重建范围
下面的示例把用户名和积分放在同一个 UserState 中。NameCard 只选择 name,ScoreCard 只选择 score。两个按钮分别更新不同字段,调试日志能直接看出重建边界。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final userProvider =
NotifierProvider<UserController, UserState>(UserController.new);
class UserState {
const UserState({
required this.name,
required this.score,
});
final String name;
final int score;
UserState copyWith({
String? name,
int? score,
}) {
return UserState(
name: name ?? this.name,
score: score ?? this.score,
);
}
}
class UserController extends Notifier<UserState> {
@override
UserState build() => const UserState(name: 'Ada', score: 0);
void addScore() {
state = state.copyWith(score: state.score + 1);
}
void rename() {
final nextName = state.name == 'Ada' ? 'Grace' : 'Ada';
state = state.copyWith(name: nextName);
}
}
void main() {
runApp(const ProviderScope(child: MyApp()));
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(home: ProfilePage());
}
}
class ProfilePage extends ConsumerWidget {
const ProfilePage({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
return Scaffold(
appBar: AppBar(title: const Text('select demo')),
body: const Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
NameCard(),
ScoreCard(),
],
),
floatingActionButton: Row(
mainAxisSize: MainAxisSize.min,
children: [
FloatingActionButton.extended(
heroTag: 'score',
onPressed: () {
ref.read(userProvider.notifier).addScore();
},
label: const Text('Score +1'),
),
const SizedBox(width: 12),
FloatingActionButton.extended(
heroTag: 'rename',
onPressed: () {
ref.read(userProvider.notifier).rename();
},
label: const Text('Rename'),
),
],
),
);
}
}
class NameCard extends ConsumerWidget {
const NameCard({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final name = ref.watch(
userProvider.select((user) => user.name),
);
debugPrint('NameCard rebuilt: $name');
return Text('Name: $name');
}
}
class ScoreCard extends ConsumerWidget {
const ScoreCard({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final score = ref.watch(
userProvider.select((user) => user.score),
);
debugPrint('ScoreCard rebuilt: $score');
return Text('Score: $score');
}
}预期结果:首次进入页面时两个卡片都会构建。点击 Score +1 后,页面积分递增,第一次点击后控制台新增 ScoreCard rebuilt: 1;继续点击会依次出现 2、3 等积分值,而 NameCard 不因积分变化重建;点击 Rename 后则相反。
select 不是 read 的替代品
如果把 NameCard 改成 ref.read(userProvider).name,第一次确实能显示名字,但后续改名不会因为这次读取触发重建。read 的语义是“一次性取得当前值”,而 select 仍然是响应式订阅,只是把订阅结果缩小。
因此优化路径应该是:先保持 watch 的正确响应式语义,确认某个状态对象的无关字段确实导致了高频重建,再把订阅改成 select。不要为了追求“少 rebuild”先牺牲界面正确性。Riverpod 官方也明确不建议用 read 来规避 watch 的更新。([Riverpod][1])
选择值要稳定且可比较
select 最适合字符串、数字、布尔值、枚举以及不可变值对象等稳定结果。如果选择的是可变集合,然后在原对象上原地修改内容,选择结果本身可能没有形成可观察到的新值,重建行为就会变得难以判断。
另外,select 本身也有少量比较和投影成本。对于构建很轻、状态更新不频繁的 Widget,直接 watch 往往已经足够清楚。只有在状态对象较大、更新频繁,且某个 Widget 明确只依赖其中一小部分时,select 才最有价值。
判断是否需要 select 的核心不是“Provider 很大”,而是“这个 Widget 实际依赖的值是否比 Provider 暴露的状态更小”。只订阅真实依赖,才能在保持响应式正确性的同时缩小重建范围。