Skip to content

性能优化: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 之后整个小程序都要等它。这四件事里,前三件在减字节与减注入,最后一件在减等待。

动手实践 ​

第一步:先录一条真实路径的基线 ​

打开微信开发者工具的「性能面板」,录制「进入商详 → 连续快速切五次规格 → 上滑三屏」。这一步不做,后面所有改动都无法归因。

js
// 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 个,每次序列化少一大截。

第三步:路径更新加合并阀门 ​

js
// 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,只传变化的字段:

js
// 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.246KB38
只加虚拟列表7.246KB41
数据出 data 加路径更新2.38KB52
加合并阀门加顶层 diff2.06KB55

第二行是这张表里最值得记的一行:三天工作量换 3 帧,两小时换 14 帧。

第四步:长列表按场景选方案 ​

定高列表用虚拟列表,可视区上下各多渲染 4 条:

vue
<!-- 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 开按需注入。

json
{
  "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 这类只有原生实现的能力接进项目。