跨平台开发 / 系统课时

选择合适的列表构建方式

选择合适的列表构建方式

Flutter 中列表性能问题通常来自一次性创建过多组件。本篇解决如何根据数据规模和交互需求选择 children、builder 与 separated,让滚动页面只创建真正需要显示的内容。

学习目标

  • 理解三种列表构建方式的创建时机和适用场景
  • 掌握 ListView.builder 在长列表中的使用方式
  • 能根据列表复杂度选择合适的实现方案

三种列表方式的差异

Flutter 常见列表主要通过 ListView 的不同构造方式创建。区别不在于最终显示效果,而在于子组件的生成策略。

children 方式会立即创建所有子组件,适合数量固定且很少的数据,例如设置页面中的几个选项。

builder 方式采用按需创建策略,滚动到可见区域时才生成对应组件,适合消息流、商品列表、日志列表等数据量较大的场景。

separated 是 builder 的扩展形式,除了按需创建列表项,还能在 item 之间自动插入分隔组件。

方式 创建策略 适用场景
children 一次创建全部子组件 少量固定内容
builder 按需创建可见区域组件 长列表、动态数据
separated 按需创建并生成分隔内容 带分割线的列表

使用 builder 构建长列表

长列表通常来自接口数据,数量可能从几十增长到几万。如果直接使用 children,所有 item 会同时进入 widget 树,增加首次构建时间和内存占用。

下面示例创建一个按需加载的商品列表。

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) {
    final products = List.generate(1000, (index) => '商品 $index');

    return Scaffold(
      appBar: AppBar(title: const Text('商品列表')),
      body: ListView.builder(
        itemCount: products.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(products[index]),
          );
        },
      ),
    );
  }
}

预期结果

text
页面显示商品列表。
滚动过程中,Flutter 根据可见区域创建对应 ListTile。
1000 个数据不会同时生成 1000 个列表组件。

children 什么时候仍然合适

虽然 children 在长列表中效率较低,但并不代表应该完全避免。

例如底部导航菜单、设置项、表单字段等通常只有几个元素,使用 children 可以让代码更直观。

dart
ListView(
  children: const [
    ListTile(title: Text('账号设置')),
    ListTile(title: Text('通知设置')),
    ListTile(title: Text('隐私设置')),
  ],
)

这种场景中,提前创建组件带来的开销很小,代码可读性反而更重要。

选择列表方式的判断方法

实际开发中可以按照数据规模和变化频率判断:

  • 数据数量小于几十且结构固定时,优先考虑 children。
  • 数据来自接口、数量不可预测时,优先使用 builder。
  • 列表项之间有统一分隔内容时,使用 separated。

不要只根据当前数据量选择方式。如果一个列表未来可能增长,提前使用懒加载结构通常更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

选择合适的列表构建方式

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

登录哪都通