鸿蒙 ArkTS 长列表性能优化:LazyForEach 与组件复用实践
在鸿蒙 ArkUI 开发中,长列表是最容易出现卡顿的场景之一。很多页面首屏正常,一旦数据量上到几百条,滚动就开始掉帧、内存持续上涨。问题通常不在数据本身,而在列表的创建与复用方式。本文结合实践梳理 ForEach 与 LazyForEach 的差异,以及使用 LazyForEach 时最容易忽略的几个细节。
ForEach 与 LazyForEach 的本质区别
ForEach 会在初次渲染时把数据源中的所有项都创建出来,适合条目数量有限、结构简单的场景,例如设置页的一小组入口。它写法直接,但条目一多就会带来明显的首屏耗时和内存压力。
LazyForEach 则按可视区域按需创建组件,只有进入视口附近的项才会实例化,滚出屏幕的节点可以被回收。对于订单列表、消息列表这类数据量不确定的页面,应当优先考虑 LazyForEach。
数据源的三个回调要配齐
LazyForEach 依赖 IDataSource 接口,需要实现 totalCount、getData、registerDataChangeListener 和 unregisterDataChangeListener。实践中常见的坑是只实现了取数方法,却没有在数据变化时调用 listener 的 onDataReload 或 onDataChange,结果就是数据已经更新,列表却纹丝不动。
建议把数据源封装成一个独立类,集中维护数组与监听者集合。新增、删除、修改分别对应不同的通知方法:局部更新用 onDataChange,整体替换再用 onDataReload,避免每次小改动都触发全量刷新。
键值生成函数决定复用是否稳定
LazyForEach 的第三个参数是键值生成函数。若使用数组下标作为键,插入或删除一条数据后,后续所有项的键都会变化,框架只能把它们当作新节点重建,复用机制形同虚设,还会出现闪烁。
更稳妥的做法是使用业务主键,例如消息 ID、订单号。键值稳定且唯一,框架才能准确识别哪一项被移动、哪一项需要更新。
减少列表项内部的无效重建
列表项组件应当尽量保持轻量。把复杂计算放在 itemGenerator 里会在每次滚动时重复执行,可以提前在数据源中算好展示字段;图片使用固定尺寸占位,避免加载完成后重新布局;子组件中用 @Prop 接收必要字段,而不是传入整个大对象,减少不必要的依赖比较。
小结
长列表优化的核心不是减少数据,而是减少同一时刻存在的组件数量与重建次数。数据量大就用 LazyForEach,配齐数据源监听,使用稳定唯一的业务键,再控制列表项内部的计算与布局开销,滚动流畅度通常就能明显提升。
- 点赞
- 收藏
- 关注作者
评论(0)