跨平台开发 / 系统课时

避免滚动列表一次性创建内容

避免滚动列表一次性创建内容

长列表性能问题通常来自一次性创建过多组件和布局对象。本篇通过惰性构建列表,让 Flutter 只创建当前屏幕附近需要显示的内容,降低首屏耗时、内存占用和滚动卡顿风险。

学习目标

  • 理解普通列表与惰性列表在组件创建时机上的区别
  • 掌握 ListView.builder 等惰性构建方式的使用场景
  • 能够判断长列表性能问题并选择合适的优化方案

为什么长列表会产生性能压力

Flutter 页面中的 Widget 虽然是轻量描述对象,但列表项通常还会包含布局计算、Element 创建以及渲染对象管理。当列表数据达到几百甚至几千条时,如果一次性创建所有子项,会导致首屏加载等待时间增加。

例如,下面这种写法会立即创建所有列表项:

dart
ListView(
  children: List.generate(
    10000,
    (index) => Text('Item $index'),
  ),
)

这种方式适合少量固定内容,例如设置页面中的几十个选项,但不适合无限滚动或大数据列表。

使用惰性构建列表

惰性列表的核心思想是按需创建。Flutter 会根据当前可见区域和缓存范围调用构建函数,用户滚动到新的区域时再创建对应列表项。

最常用的是 ListView.builder:

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MaterialApp(home: ProductListPage()));
}

class ProductListPage extends StatelessWidget {
  const ProductListPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Products')),
      body: ListView.builder(
        itemCount: 10000,
        itemBuilder: (context, index) {
          // 只有列表项需要显示时才创建对应 Widget
          return ListTile(
            title: Text('Product $index'),
          );
        },
      ),
    );
  }
}

运行后,页面不会一次创建 10000 个 ListTile,而是在滚动过程中逐步生成可见区域需要的内容。

预期结果

text
页面首次打开速度更快。
滚动时按需创建列表项,内存占用低于一次性创建所有子项的方式。

builder 方式适合哪些场景

ListView.builder 适用于数据量较大或数量动态变化的列表,例如:

  • 商品列表
  • 消息记录
  • 社交动态流
  • 文件目录
  • 搜索结果列表

如果列表内容很少,直接使用 children 方式反而更简单,因为代码可读性更高。

进一步减少列表创建成本

除了使用惰性构建,还需要避免列表项内部存在过重结构。常见优化包括:

  • 避免每次构建创建无关的大对象
  • 将复杂列表项拆分为独立 Widget,方便 Flutter 复用和更新
  • 对固定高度列表项使用 itemExtent 提供布局提示

例如:

dart
ListView.builder(
  itemExtent: 56,
  itemCount: 1000,
  itemBuilder: (context, index) {
    return ListTile(
      title: Text('Message $index'),
    );
  },
)

itemExtent 可以帮助 Flutter 更快计算滚动位置,尤其适合高度固定的列表。

什么时候不应该使用惰性列表

惰性构建不是所有列表的默认答案。以下情况可以直接使用普通 children:

  • 项目数量非常少
  • 所有内容都需要同时展示
  • 列表结构简单且不会增长

优化列表性能时,首先判断数据规模和用户交互方式,再选择创建策略。惰性构建解决的是大规模内容按需生成问题,而不是所有页面都必须使用的固定模式。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免滚动列表一次性创建内容

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

登录哪都通