跨平台开发 / 系统课时

用 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。两个按钮分别更新不同字段,调试日志能直接看出重建边界。

dart
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 暴露的状态更小”。只订阅真实依赖,才能在保持响应式正确性的同时缩小重建范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 select 缩小重建范围

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

登录哪都通