性能优化:布局、长列表与帧率分析
本篇要点:拿到一个“越滑越卡”的列表页,能按帧率数据把问题分诊到 UI 线程还是渲染线程,再用最小改动验证假设。 前置文章:《系统能力:媒体、权限与后台任务》把媒体、权限与后台任务接进了应用,这一章处理它们带来的开销。
为什么需要它
2026 年 4 月,一个 2000 条数据的商品列表页摆在面前。首屏进去还算顺,往下滑三屏开始掉帧,滑到第七八屏手感明显发黏。列表用的是 LazyForEach,IDataSource 是团队自己实现的。
第一反应是复用没生效。这个判断在当时看来很合理:越滑越卡,不就是节点越建越多。
于是改了一串东西。给列表项加 @ReusableV2,在回收回调里把定时器清掉,cachedCount 从 2 调到 6,key 从 index 换成商品 ID,把列表项里三层嵌套的 Column > Row > Stack 压成 RelativeContainer。每改一项,用 Frame Profiler 录一次。
两个工作日过去,帧率从 47fps 到 51fps。卡顿帧的分布完全没变,还是滑到中后段开始密集。第三天下班前,这些改动全部回滚,然后在另一个文件里加了六行代码,平均帧率回到 59fps。
前面两天的工作,一行没留。
这个结果本身就否掉了最初的假设。如果真是节点堆积,cachedCount 和层级压平应该会改变曲线形状。它们没有。
这一章按复盘顺序讲:先算一帧的账,再看数据怎么分诊,最后才是具体那几行代码。顺序反了,两天就是这么花掉的。
版本基线:截至 2026 年 11 月,页面在 HarmonyOS 6.0.0(API 20,2025 年 9 月 25 日 Release)与 DevEco Studio 6.0.0 上测。Repeat 从 API 12 起可用,@ReusableV2 从 API 18 起可用;停在更早版本的项目,有些手段用不上,排查思路不变。
核心概念
帧预算:16.7ms 里要干完四件事
定义:帧预算(frame budget)是屏幕刷新一次留给应用的时间。60Hz 屏幕下是 16.7ms,120Hz 下只有 8.3ms。
这 16.7ms 里,ArkUI 要顺序做完四步:状态变更触发 build() 重跑、measure 自顶向下传约束、layout 自底向上定位置与尺寸、draw 生成绘制指令交给 RenderService 合成上屏。
图 7-1 一帧的四个阶段与卡顿判定
如图 7-1 所示,那个 D 判断是最容易被忽略的分叉。父容器尺寸不明确时,框架要再测一轮,这一轮是白扔的。子组件尺寸依赖父容器的内容、百分比再叠加内边距时,容易制造这种二次测量。
UI 段与渲染段:先分诊再动手
定义:UI 段是 UI 线程上 build、measure、layout、draw 的耗时;渲染段是 RenderService 在渲染线程上合成上屏的耗时。
这个区分决定了你该查什么。渲染段长,去查图片、模糊、阴影、超采样;UI 段长,去查 build 与布局,别碰图片。
关键是前三步全跑在 UI 线程上,而 UI 线程同时在接手势、接网络回调、跑定时器。它一堵,手势就先丢。
那次排查里,单帧详情显示 UI 段 22ms 左右、渲染段 4ms。渲染没问题,全卡在 UI 线程。
布局回调回写:一个会反复触发的循环
定义:onAreaChange 是布局完成后的回调,参数是组件区域的前后值。
在它里面改 @State,会立刻再触发一轮 build,再触发一轮 measure 和 layout,然后 onAreaChange 又回调一次。宽度其实没变,但赋值动作发生了。@State 对简单类型按赋值判断,赋相同的值也会走一遍通知流程。
这类问题的形状很好认:它不是常数开销,而是随交互次数增长的开销。2000 条数据、每屏十几个可见项,滚动时每一项都在做这件事,滚得越多,循环触发得越多。曲线是往上翘的,而节点堆积是常数级的,滑到第一屏和第一百屏差不多。
长列表:虚拟滚动、复用与缓存窗口
定义:虚拟滚动(virtual scrolling)指只为可见区域及少量缓冲创建组件节点;组件复用(component reuse)指滑出屏幕的组件实例被回收,滑入时用旧实例重建,而不是新建。
LazyForEach 需要自己实现 IDataSource 的四个方法,并在数据变化时通过 DataChangeListener 通知框架。它的隐式约定不少:onDataChange 之后必须保证 getData(index) 返回新数据,onDataReloaded 会重建全部可见项,键值不变时框架不重建节点。
Repeat 从 API 12 起可用,不用手写 IDataSource,用 .virtualScroll({ totalCount }) 声明虚拟滚动。@ReusableV2 从 API 18 起可用,管的是组件实例复用,与节点回收是两层机制。
cachedCount 是缓存窗口:屏幕外多保留几屏的节点。它影响的是快速滑动时会不会白屏,以及首帧要建多少东西。这两个目标会打架。
动手实践
第一步:先录一段基线
打开 DevEco Studio 的 Frame Profiler,在真机上滑 10 秒,录完先看两件事:平均帧率、卡顿帧占比。再点开一个卡顿帧,看 UI 段和渲染段谁更长。
当时的四次测量结果如下。
| 改动 | 平均帧率 | 卡顿帧占比 |
|---|---|---|
| 改动前 | 47fps | 31% |
加 @ReusableV2 + 清理定时器 | 48fps | 29% |
cachedCount 2→6 | 51fps | 24% |
key 换业务 ID + 压平层级 | 51fps | 23% |
运行结果:后两项加起来只换来 3 个百分点,且卡顿帧分布不变。这张表的作用不是记录收益,而是排除假设——真凶如果是节点堆积,曲线形状会变。这些数字只在一台 4C8G 的中端机和一台旗舰机上成立,换机型要重测。
第二步:展开调用栈,找到高频函数
Profiler 里展开一个卡顿帧的调用栈,会看到一个反复出现的函数名:onAreaChange。顺着它找到列表项里那个“自适应卡片”组件,它为了在宽度变化时切换紧凑/宽松两种排版,写了这么一段。
// 当时的写法(有问题的版本)
@State cardWidth: number = 0;
build() {
Column() {
// ...内容
}
.onAreaChange((oldValue: Area, newValue: Area) => {
this.cardWidth = Number(newValue.width); // 布局完成后回写状态
})
}运行结果:界面看起来完全正常,不报错、不崩溃,宽度变化时排版也确实切换了。代价只有在它被创建几百次之后才显现:滑动中每一帧都在多跑一轮 build 与 measure。
第三步:把逐像素回写改成跨档回写
// 修完的版本:只在宽度真的变了才更新,且用断点代替逐像素响应
@State cardWidth: number = 0;
private applyWidth(w: number): void {
// 断点化:只有跨档才回写,避免逐像素抖动
const bucket: number = w < 320 ? 320 : (w < 480 ? 480 : 640);
if (bucket !== this.cardWidth) {
this.cardWidth = bucket;
}
}
build() {
Column() {
// ...内容
}
.onAreaChange((oldValue: Area, newValue: Area) => {
this.applyWidth(Number(newValue.width));
})
}运行结果:复测平均 59fps,卡顿帧占比 4%。六行代码,改的是“什么时候允许写状态”,不是布局写法。
这里的通用原则是:布局回调里不要无条件写状态;确实要写,就先做值比较或断点化,让写入次数与真实变化次数挂钩,而不是与布局次数挂钩。团队现在的约定更直接:列表项里禁用 onAreaChange 回写状态,靠 code review 拦。框架没禁这个用法,是因为有些自适应布局确实需要它。
第四步:详情页的图片,按显示尺寸解码
列表修完,详情页还是卡。详情页只有一张主图,所以没人往那儿想。
原因很简单:Image($r('app.media.photo')) 加载的是 4000×3000 的原图,显示区域只有 360vp 宽。解码器把原图完整解出来,再缩到显示尺寸,内存占用是显示所需的几十倍,解码本身还在 UI 线程附近排队。
// 前提:API 20;@kit.ImageKit + @kit.CoreFileKit
import { image } from '@kit.ImageKit';
import { fileIo as fs } from '@kit.CoreFileKit';
async function loadThumb(uri: string, targetVp: number): Promise<image.PixelMap> {
const file = fs.openSync(uri, fs.OpenMode.READ_ONLY);
const source = image.createImageSource(file.fd);
// desiredSize 让解码器直接输出目标尺寸
const pixelMap = await source.createPixelMap({
desiredSize: { width: targetVp * 2, height: targetVp * 2 }, // 屏密度按 2x 估
desiredPixelFormat: image.PixelMapFormat.RGBA_8888,
editable: false
});
await source.release();
fs.closeSync(file);
return pixelMap;
}运行结果:360vp 的显示区域拿到 720×720 的 PixelMap,解码耗时与内存占用按显示尺寸走,详情页滑动不再掉帧。
顺带排除一个常见开关:不要为了“避免图片闪烁”打开 syncLoad(true)。它把解码压进 build 阶段,等于用掉帧换闪一下。列表里的图片配 alt 备用图、给固定高度,比什么开关都管用。
动画同理。用 setInterval 每帧改 width 做展开,等于让业务代码接管补间,任何一帧的业务抖动都会变成画面抖动;改 translate、scale、opacity 只影响绘制与合成,改 width、height、margin 每帧都要重新 measure 与 layout。
第五步:要不要换 Repeat
修复后做了一轮压力测试,把 LazyForEach 换成 Repeat,看还能榨出多少。
// Repeat 版本:注意 key 必须用业务 ID
List() {
Repeat<Goods>(this.goods)
.each((ri: RepeatItem<Goods>) => {
ListItem() {
GoodsCard({ goods: ri.item })
}
})
.key((item: Goods) => item.id)
.virtualScroll({ totalCount: this.goods.length })
}
.cachedCount(4)运行结果:这个页面上 Repeat 与 LazyForEach 的帧率差距在 1fps 以内,代码量少了一截,不用维护 IDataSource 与 DataChangeListener。
结论是新写的列表用 Repeat,已经在跑的 LazyForEach 不要为了性能去换。为了 1fps 重写一套隐式约定很多的实现,收益是负的。
cachedCount 最后定在 4。调到 10 时快速滑动确实不白屏了,但首帧时间从 620ms 涨到 810ms。这个页面的用户大多从搜索进来直接看第一屏,首帧比滑动流畅更值钱。
第六步:固定排查顺序
这一轮之后,顺序改成了下面这样,不要倒着来。
| 顺序 | 看什么 | 常见原因 |
|---|---|---|
| 1 | 单帧 UI 段与渲染段谁更长 | 渲染段长查图片与特效,UI 段长查 build 与布局 |
| 2 | 组件树深度(ArkUI Inspector) | 超过 8 层通常能压到 5 层内,常见“为一个圆角套三层容器” |
| 3 | build() 里有无重计算 | filter、sort、JSON.parse、长字符串模板拼接 |
| 4 | 最后才怀疑复用 | IDataSource 实现、key 稳定性、回收回调 |
运行结果:按这个顺序,同类问题半天能定位;按倒序查,就是两天。
这套顺序只对“滑动持续掉帧”有效。如果是“页面进得去但首屏白了一秒”,那查的是启动链路:onCreate 里的同步 IO、aboutToAppear 里的首屏请求、首页布局层级过深导致首帧 measure 超时,这三处是常见源头。两类现象混在一起查,两边都查不动。
常见误解
以为“越滑越卡”就是节点堆积。 节点堆积是常数级开销,滑到第一屏和第一百屏差不多;随滑动距离增长的曲线,只可能来自随交互累积的动作,比如布局回调里的状态回写、事件监听没解绑、定时器叠加。
以为 Repeat 一定比 LazyForEach 快。 实测差 1fps 以内,收益主要在代码量与维护成本。老列表为了这点差距重写数据源,是负收益;那次还试过“保留 LazyForEach、只把列内标签换成 Repeat”的半换方案,帧率没变,可读性变差,第二天回滚了。
以为 cachedCount 越大越流畅。 它买到的是快速滑动不白屏,付出的是首帧时间:2→6 让帧率从 48 到 51,6→10 则把首帧从 620ms 推到 810ms。给搜索落地页调大缓存,是拿首屏换滑屏。
小结
- 先算帧预算:60Hz 一帧 16.7ms,build、measure、layout、draw 四步都在 UI 线程上,UI 线程还同时接手势与回调。
- 分诊看单帧:渲染段长查图片与特效,UI 段长查 build 与布局。那次 UI 段 22ms、渲染段 4ms,方向一开始就定错了。
- 布局回调里写状态要有条件:值比较或断点化,让写入次数跟真实变化走。六行改动把 51fps 拉到 59fps、卡顿帧从 23% 降到 4%。
- 图片按显示尺寸解码,
desiredSize比事后缩放省内存也省时间;不要用syncLoad(true)换闪烁。 - 复用与缓存是常数级优化,解决不了累积型掉帧;
cachedCount与首帧时间要一起量。
相关主题
单机页面调到 59fps 之后,下一类问题不是更快,而是更远:同一份数据要在手机、平板、车机之间流转。相关文章进入[《分布式能力:跨设备流转与协同》 分布式能力](/guide/harmonyos/harmonyos-distributed-collaboration.html),讲跨端迁移、分布式数据对象与分布式文件各自能做什么、在哪里必须停手。