性能优化:setData、长列表与首屏加载
本篇要点:能算清一次 setData 的成本,按「减数据、减次数、减节点」的顺序治理卡顿,并用可复现的数字证明收益。 前置文章:《网络与数据:请求封装、缓存与状态管理》把请求、缓存与状态管起来了;这一章看这些数据从逻辑层走到视图层,要付多少运费。
为什么需要它
一个日活四万、商详页日访问二十万的小程序,商品列表快速滑动时掉帧(FPS,每秒帧数)。团队第一反应是渲染的锅,花三天做了虚拟列表,帧率从 38 涨到 41。真正把它推到 55 的,是把其中一次商品卡片点击里的 9 次 setData 合并成 2 次——改了两小时。
这个反差说明一件事:卡顿要先归因再动手。线上反馈里绝大多数落在三处:setData 传得太多、列表渲染得太长、首屏加载得太晚。三者对应三种不同的成本,治理顺序反了,力气就白花。
基线:uni-app Vue3 加微信小程序基础库 3.x,测试机是一台 2019 年的千元安卓,截至 2026 年 11 月。下面的数字都来自这台机器上的录屏操作,只看相对变化,绝对值换设备就失去意义。
核心概念
setData 是跨线程搬运,不是赋值
小程序把逻辑层和视图层放在两个独立运行环境里,编译到小程序的 uni-app 也一样。setData 不是给对象赋值,是一次跨线程数据搬运,链路上四个环节都随数据量增长,如图 5-1 所示。
图 5-1 一次 setData 的完整链路
三个结论从这张图直接推出来。一次 setData 就是一个批次,频率高比单次大更伤,因为每批都要走完整链路。序列化意味着函数、undefined、循环引用都传不过去,会静默丢失。单次数据量上限在 1MB 量级,超了直接报错,那是崩溃线,不是建议值。
那次改造前的分布:商详页一次点击平均触发 7.2 次 setData,单次平均 46KB,最大一次 320KB——传的是整个 SKU(Stock Keeping Unit,商品规格单元)列表,而用户只是切换了一个规格。
数据量与节点数是两种成本
节点多,贵在样式计算、布局与绘制;数据多,贵在序列化与传输。把两者混为一谈,就会出现「给 40 条列表上虚拟列表」这种事:节点数从来不是瓶颈,帧率只涨了 3。
类比:节点数是一张桌子上摆多少盘子,数据量是每次端菜要跑多远。盘子多,收拾桌子慢;跑得远,上菜慢。两个问题要两副药。
反例是先上虚拟列表再谈其他。把顺序倒过来——先量数据,再看节点——才知道该动哪一头。
合并阀门:一次交互只过桥一次
一次点击里连着改五个字段,如果每次都 setData,就是五次完整链路。合并阀门(batching)把所有修改压到本轮微任务(microtask)末尾,一帧只过桥一次。
选微任务不选 setTimeout,是因为微任务在同一帧内必然执行完,而 setTimeout 有可能被排到下一帧,反而把一次交互拆成两次过桥。
路径更新是另一半:只改 skus[3].checked,不传整个数组。代价是字符串 key 里的索引算错不会报错,改的是别的项——第一版就点第三个规格,高亮了第二个。
首屏:三个阻塞点
首屏时间不是「接口快」一件事。主包(首次启动必须下载的那部分代码)体积决定下载与解析时长,未使用的代码决定注入与执行时长,字体与图片决定首次绘制能不能按时出现。
分包把非首屏页面挪出主包;lazyCodeLoading 让小程序只注入当前页面用到的代码;图片用 lazy-load 加 CDN 按尺寸取图,避免用 2000px 原图渲染 200px 的格子;网络字体是阻塞文字渲染的,wx.loadFontFace 加上 global: true 之后整个小程序都要等它。这四件事里,前三件在减字节与减注入,最后一件在减等待。
动手实践
第一步:先录一条真实路径的基线
打开微信开发者工具的「性能面板」,录制「进入商详 → 连续快速切五次规格 → 上滑三屏」。这一步不做,后面所有改动都无法归因。
// utils/perf.js —— 只在微信小程序端打点
// #ifdef MP-WEIXIN
const launchAt = Date.now()
// 不同基础库版本暴露的 entryType 有差异,先打印再取
const perf = wx.getPerformance()
console.log('[perf] entries', perf.getEntries().map(e => ({
name: e.name, type: e.entryType, duration: Math.round(e.duration)
})))
// 第一个参数是后台「性能监控 - 自定义测速」申请的指标 id,第三个是分组维度
wx.reportPerformance(12001, Date.now() - launchAt, 'cold_start')
// #endif运行结果:控制台打出若干条 [perf] entries,能看到 navigation、render、script 等 entryType 与各自耗时;后台的自定义测速面板在几十秒后出现一条 cold_start 记录。压测时别开 vConsole(调试面板)——它本身拉低帧率、放大渲染耗时,两边都开着测出来的「优化前后无差异」是假象。
第二步:把不参与渲染的数据搬出 data
定时器 id、缓存的原始响应、上一个规格的选择态,全部挂到页面实例上,不进 data。这一步在工具里就能看到:页面实例的 data 从 11 个字段降到 5 个,每次序列化少一大截。
第三步:路径更新加合并阀门
// pages/detail/detail.js
Page({
data: { skus: [], selected: 0, loading: false },
onLoad() {
this.patch = createPatcher(this)
this.queued = null
this.scheduled = false
},
// 同一轮事件循环内的多次修改合并成一次过桥
schedule(next) {
this.queued = { ...(this.queued || {}), ...next }
if (this.scheduled) return
this.scheduled = true
Promise.resolve().then(() => {
this.scheduled = false
const payload = this.queued
this.queued = null
if (payload) this.patch(payload)
})
},
onSelectSku(e) {
const i = Number(e.currentTarget.dataset.index)
// 只传被点中的那一项和一个标量,不传整个数组
this.schedule({ [`skus[${i}].checked`]: true, [`skus[${this.data.selected}].checked`]: false })
this.schedule({ selected: i })
}
})运行结果:一次连续切规格的点击,性能面板里 setData 次数从 7 次左右降到 2 次,单次体积从 46KB 降到 6KB 上下;点击到渲染完成的耗时从约 420ms 降到约 150ms。索引写错时页面不会报错,只是高亮错项,所以第一版上线前把 i 和 this.data.selected 打出来对一遍。
createPatcher 做顶层 key 级 diff,只传变化的字段:
// utils/patcher.js
export function createPatcher(page) {
let snapshot = {}
return function patch(next) {
const delta = {}
for (const key of Object.keys(next)) {
if (JSON.stringify(snapshot[key]) === JSON.stringify(next[key])) continue
delta[key] = next[key]
}
if (Object.keys(delta).length === 0) return
page.setData(delta)
snapshot = { ...snapshot, ...delta }
}
}运行结果:同一页面重复点同一个规格时,控制台看不到新的 setData 调用,因为 delta 为空直接返回;脚本时间下降,帧率不变。它只比顶层 key,嵌套对象里改一个字段仍会整块传。
几轮改动做完,同一台机器、同一个页面、同一段录屏操作,数据是这样变的:
| 阶段 | 单次交互 setData 次数 | 平均单次体积 | 滚动 FPS |
|---|---|---|---|
| 改造前 | 7.2 | 46KB | 38 |
| 只加虚拟列表 | 7.2 | 46KB | 41 |
| 数据出 data 加路径更新 | 2.3 | 8KB | 52 |
| 加合并阀门加顶层 diff | 2.0 | 6KB | 55 |
第二行是这张表里最值得记的一行:三天工作量换 3 帧,两小时换 14 帧。
第四步:长列表按场景选方案
定高列表用虚拟列表,可视区上下各多渲染 4 条:
<!-- components/virtual-list/virtual-list.vue —— 定高虚拟列表 -->
<template>
<scroll-view scroll-y :style="{ height: viewportH + 'px' }" @scroll="onScroll">
<view :style="{ height: totalH + 'px', position: 'relative' }">
<view
v-for="row in visibleRows"
:key="row.id"
:style="{ position: 'absolute', left: '0', right: '0', top: row.__top + 'px', height: itemH + 'px' }"
>
<slot :item="row" />
</view>
</view>
</scroll-view>
</template>
<script setup>
import { computed, ref, onMounted } from 'vue'
const props = defineProps({
items: { type: Array, default: () => [] },
itemH: { type: Number, default: 88 }, // 定高是前提,不定高要做测量,成本翻倍
buffer: { type: Number, default: 4 }
})
const viewportH = ref(600)
const start = ref(0)
onMounted(() => {
viewportH.value = uni.getSystemInfoSync().windowHeight
})
const totalH = computed(() => props.items.length * props.itemH)
const count = computed(() => Math.ceil(viewportH.value / props.itemH) + props.buffer * 2)
const visibleRows = computed(() =>
props.items.slice(start.value, start.value + count.value)
.map((it, i) => ({ ...it, __top: (start.value + i) * props.itemH }))
)
function onScroll(e) {
start.value = Math.max(0, Math.floor(e.detail.scrollTop / props.itemH) - props.buffer)
}
</script>运行结果:1000 条数据时同时存在的节点稳定在 20 个上下,滚动帧率不再随数据量下降;40 条数据时几乎没有变化,这也正是「先上虚拟列表只涨 3 帧」的原因。列表总高变成计算值之后,scroll-into-view、回到顶部、下拉刷新都要改成按索引换算,不能再依赖节点位置——改完虚拟列表,「回到顶部」按钮失灵了两天。
第五步:首屏按「减字节、减注入、减等待」排
改 pages.json 的三个字段:pages 只留首屏,subPackages 收商详,lazyCodeLoading 开按需注入。
{
"pages": [{ "path": "pages/index/index" }],
"subPackages": [
{ "root": "pkg-detail", "pages": [{ "path": "detail/index" }] }
],
"lazyCodeLoading": "requiredComponents"
}运行结果:主包体积下降,商详页从主包移到 pkg-detail,开发者工具「代码依赖分析」里主包占比变小;首屏只注入 index 页用到的组件,自定义组件越多,首屏要注入的代码越少,冷启动脚本时间差距越大。lazyCodeLoading 要求基础库 2.11.1 及以上,低版本会忽略这项配置。
常见误解
其一,以为「只传变化字段」总是更快。createPatcher 里那句 JSON.stringify 在一个 200 条、每条 8 个字段、每 3 秒轮询的行情页上翻了车:setData 次数降了,脚本执行时间涨了 30%,帧率从 47 掉到 44。序列化 200 条做比较,比直接传一遍还贵。条目少、字段深、改动频率低,diff 划算;条目多、字段浅、整批替换,直接传更省。方向不等于铁律。
其二,以为虚拟列表是长列表的通用解。不定高的商品流或聊天记录要靠预测量加动态校正,实现复杂度和滚动抖动都翻倍,用户看得见跳动。商品卡、消息气泡这类场景,统一卡片高度是更便宜的选择。用 index 做 key 也不是风格问题,是复用错位,表现为滑一下内容串行,而且只在特定滑动速度下复现。
其三,以为性能面板的数据能代表线上。面板的采样只覆盖你手动操作的那几秒;商详页在面板里表现良好,线上反馈依然不少,原因是面板里从不点「连续快速切规格」。把真实用户路径录一遍重测,才复现出来。模拟器性能也远好于真机,低端机才暴露问题。
其四,以为首屏只靠分包。字体是阻塞文字渲染的,动态字体砍掉、只留图标字体之后,首屏文字才不再等网络;图片不按尺寸取,解码与内存都压在首屏。分包只解决「要下载多少代码」,不解决「第一帧要等什么」。
小结
《网络与数据:请求封装、缓存与状态管理》把数据管起来,这一章说明数据到视图层是有运费的。五条要点:
- setData 是跨线程搬运,链路四步:序列化、传输、反序列化 diff、更新绘制;频率比单次体积更伤。
- 先量数据,再看节点。40 条列表上虚拟列表只值 3 帧,合并 9 次 setData 值 14 帧。
- 合并阀门用微任务,路径更新用字符串 key,索引写错不报错。
- diff 有成本:条目多、字段浅、整批替换时直接传更快。
- 首屏分三类:减字节靠分包,减注入靠
lazyCodeLoading,减等待靠图片按尺寸与字体不阻塞。面板、体验评分、真机弱网三层配合,vConsole 必须关。
相关主题
页面快起来之后,下一步是让它能碰硬件。[《原生能力:UTS 插件与原生插件开发》](/guide/uniapp/uniapp-native-plugin-uts.html)从 UTS 的编译期翻译讲起,把相机、蓝牙、厂商 SDK 这类只有原生实现的能力接进项目。