ArkUI 长列表性能优化实战:LazyForEach 与 @Reusable 组件复用
一、问题从哪来
在做信息流、消息列表或通讯录这类长列表页面时,很多人会先撞上一个共同的现象:数据量一旦到上千条,进入页面的白屏时间明显变长,滑动开始掉帧,内存曲线持续上涨。排查下去,问题往往既不在网络请求,也不在图片解码,而在于用 ForEach 直接把整个列表渲染了出来。
ForEach 的语义是全量渲染。页面创建时,它会把数据源里的每一条数据都实例化成组件;数据变更时,再按 key 做一次完整比对。条目少的时候没有任何感觉,上千条就足以把主线程压垮。正确的做法是换成 LazyForEach:它只创建可视区域以及少量缓存区内的组件,滑出屏幕的组件被回收,滑入时按需构建,从根本上减少了同一时刻存在的组件数量。
二、LazyForEach 需要一个数据源
LazyForEach 不接受普通数组,它要求传入一个实现了 IDataSource 接口的数据源对象。这个接口很朴素:totalCount 返回条目总数,getData 按索引取数据,再加上一对注册与注销数据变更监听的方法。下面是一个最小可用实现。
class BasicDataSource implements IDataSource {
private listeners: DataChangeListener[] = [];
private dataArray: Item[] = [];
public totalCount(): number {
return this.dataArray.length;
}
public getData(index: number): Item {
return this.dataArray[index];
}
registerDataChangeListener(listener: DataChangeListener): void {
if (this.listeners.indexOf(listener) < 0) {
this.listeners.push(listener);
}
}
unregisterDataChangeListener(listener: DataChangeListener): void {
const pos = this.listeners.indexOf(listener);
if (pos >= 0) {
this.listeners.splice(pos, 1);
}
}
public addData(index: number, item: Item): void {
this.dataArray.splice(index, 0, item);
this.listeners.forEach((listener: DataChangeListener) => {
listener.onDataAdd(index);
});
}
}
页面里使用的时候,把它交给 List,并注意第三个参数是 key 生成器。
List({ space: 8 }) {
LazyForEach(this.source, (item: Item) => {
ListItem() {
ItemView({ item: item })
}
}, (item: Item) => item.id)
}
.cachedCount(3)
三、两个容易被忽略的参数
第一个是 key 生成器。它必须返回稳定且全局唯一的字符串。用数组下标当 key 是最常见的错误:在列表头部插入或删除一条之后,后面所有条目的 key 会整体平移,框架会认为这些组件"换了身份",于是把旧组件销毁、新组件重建。表现出来的现象是插入一条数据后整屏闪一下,滚动位置也跟着乱。
第二个是 cachedCount,它决定屏幕之外预加载多少条。设得太小,快速滑动时会出现空白占位;设得太大,内存占用又会回升。一般从 2 到 3 起步,再按条目的复杂程度微调。
四、组件复用解决另一件事
LazyForEach 解决的是"少建",而 @Reusable 解决的是"重建"。列表项组件加上 @Reusable 装饰器之后,滑出屏幕的组件实例不会立即销毁,而是进入复用池;滑入时直接把旧实例拿来用,并在 aboutToReuse 回调里接收新的数据。
@Reusable
@Component
struct ItemView {
@State item: Item = new Item();
@State expanded: boolean = false;
aboutToReuse(params: Record<string, Object>): void {
this.item = params.item as Item;
this.expanded = false;
}
build() {
Column() {
Text(this.item.title)
.fontSize(16)
if (this.expanded) {
Text(this.item.detail)
.fontSize(14)
}
}
.onClick(() => {
this.expanded = !this.expanded;
})
}
}
这里有个必须记住的坑:复用组件内部的 @State 不会被自动重置。假如列表项带"展开/收起"这种交互状态,复用之后会带着上一条的状态出现,用户看到的就是"点开一条,另一条也自己展开了"。解决办法只有一个,在 aboutToReuse 里把它显式归零。
五、数据变了要主动通知
直接对内部数组做 push 或修改,UI 是不会刷新的,因为框架并不知道数据源变了。必须通过监听回调把变更告诉 LazyForEach:新增调用 onDataAdd,修改调用 onDataChange,删除调用 onDataDelete,批量重载才用 onDataReloaded。onDataReloaded 会让整段列表重建,能不用就不用。
六、还有几个常见坑
LazyForEach 必须直接放在 List、Grid、Swiper 这类滚动容器内部,如果被包在 if 条件渲染里,懒加载会失效,退化成一次性全建。嵌套滚动也要谨慎,内层滚动容器会抢走手势,导致外层列表拖不动。
七、改造后的实际感受
同一个千条级别的消息列表,从 ForEach 换成 LazyForEach 并给列表项加上 @Reusable 之后,进入页面基本看不到白屏,长距离快速滑动不再出现明显掉帧,内存占用随滑动趋于平稳而不是一路上涨。具体收益与设备性能、条目复杂度强相关,不建议直接套用别人的数字,最好用 DevEco Studio 的性能分析工具在自己的工程里做前后对比。
八、小结
长列表卡顿不是玄学:先用 LazyForEach 把"全量创建"改成"按需创建",再用 @Reusable 把"反复重建"改成"实例复用",最后保证数据变更走通知、key 保持稳定唯一,三个动作做到位,绝大多数列表性能问题都会消失。
- 点赞
- 收藏
- 关注作者
评论(0)