Skip to content

性能优化:布局、长列表与帧率分析 ​

本篇要点:拿到一个“越滑越卡”的列表页,能按帧率数据把问题分诊到 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 段和渲染段谁更长。

当时的四次测量结果如下。

改动平均帧率卡顿帧占比
改动前47fps31%
加 @ReusableV2 + 清理定时器48fps29%
cachedCount 2→651fps24%
key 换业务 ID + 压平层级51fps23%

运行结果:后两项加起来只换来 3 个百分点,且卡顿帧分布不变。这张表的作用不是记录收益,而是排除假设——真凶如果是节点堆积,曲线形状会变。这些数字只在一台 4C8G 的中端机和一台旗舰机上成立,换机型要重测。

第二步:展开调用栈,找到高频函数 ​

Profiler 里展开一个卡顿帧的调用栈,会看到一个反复出现的函数名:onAreaChange。顺着它找到列表项里那个“自适应卡片”组件,它为了在宽度变化时切换紧凑/宽松两种排版,写了这么一段。

ts
// 当时的写法(有问题的版本)
@State cardWidth: number = 0;

build() {
  Column() {
    // ...内容
  }
  .onAreaChange((oldValue: Area, newValue: Area) => {
    this.cardWidth = Number(newValue.width);   // 布局完成后回写状态
  })
}

运行结果:界面看起来完全正常,不报错、不崩溃,宽度变化时排版也确实切换了。代价只有在它被创建几百次之后才显现:滑动中每一帧都在多跑一轮 build 与 measure。

第三步:把逐像素回写改成跨档回写 ​

ts
// 修完的版本:只在宽度真的变了才更新,且用断点代替逐像素响应
@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 线程附近排队。

ts
// 前提: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,看还能榨出多少。

ts
// 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 层内,常见“为一个圆角套三层容器”
3build() 里有无重计算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),讲跨端迁移、分布式数据对象与分布式文件各自能做什么、在哪里必须停手。