性能优化:渲染性能、长列表与加载策略
本篇要点:能用 Performance 面板和 INP 数据判断一次列表卡顿属于哪类开销,按"减节点、减更新、减数据"的顺序优化,并用基线证明收益。 前置文章:《组件库与设计系统:从零封装可复用组件》把界面拆成了可复用的组件,这一章关心的是积木多到一万块时,页面还转不转得动。
为什么需要它
2026 年 5 月,一个订单管理页,运营要求"一次加载全部待处理订单",接口照做了,返回一万二千行。产品经理点开筛选条件选"全部",标签页卡死十二秒;页面终于出来,滚动条一拉就白屏。
第一反应是 Vue 的响应式系统在大数组上开销太大。于是上 shallowRef、上 markRaw,改了三天,卡死时间从 12 秒降到 9.8 秒。
节点数没变,一切都不会变。一万二千行就是一万二千个 DOM 节点,响应式优化只压低了每个节点的更新开销,没有减少节点本身。
这一章的三件事有严格顺序:虚拟滚动解决"渲染多少行",稳定 key 与薄行组件解决"更新多少行",分页缓存解决"取多少条"。跳过前两件直接做第三件,等于什么都没做。
版本基线:截至 2026 年 11 月,vue@latest 是 3.5.45,3.6 仍在 RC(最新 3.6.0-rc.15)。虚拟滚动的参数语义以 @tanstack/vue-virtual 3.13.x 为准。
核心概念
长任务与 INP:两个不同的信号
主线程上连续占用超过 50 毫秒的任务叫长任务(long task),浏览器会把它标红——超过 50 毫秒,这一帧就保不住了,用户看到的是掉帧。INP(Interaction to Next Paint,交互到下一次绘制)量的是从用户点击到界面给出反馈的时间,good ≤ 200 毫秒,poor > 500 毫秒。
长任务像超市只开一个收银台,一个大单结完后面全在等;INP 是顾客从放下商品到拿到小票的时间。前者解释卡顿,后者解释体感。
反例是把两者混在一张火焰图里看,结论只会是"到处都是红的"。正确做法是拆成三个独立信号:
| 信号 | 判读 | 对应方向 |
|---|---|---|
| Long Task 数量 | 超过 50 ms 标红,是掉帧的直接证据 | 先确认是不是主线程阻塞 |
| Scripting 占比高 | patchKeyedChildren、renderComponentRoot 集中在滚动帧 | 每帧在重渲染整棵列表 |
| Rendering / Painting 占比高 | Recalculate Style、Layout 跟着滚动条一路出现 | 滚动中在读写尺寸或反复重绘 |
虚拟滚动:渲染的是窗口,不是列表
虚拟滚动(virtual scrolling)只渲染可视区加少量缓冲行,用一个撑高元素维持滚动条长度,滚动时重算窗口而不是重渲染整个列表,流程如图 8-1 所示。
图 8-1 虚拟滚动的窗口计算流程
图里有一条容易被跳过的推论:总高度决定滚动条长度,而行高不确定时总高度只能是估算值。所以行高变化剧烈的列表——折叠面板、图片懒加载、可换行的备注——滚动过程中会不断修正偏移,表现出来就是"滚动条在跳"。
反例是以为虚拟滚动等于"一次渲染一万行但渲染得快"。它压根不渲染那一万行,只渲染二十来行。节点数从万级降到百级,这才是它起作用的原因。
窗口参数:count、estimateSize、overscan
count 是数据总条数,estimateSize 是每行的估算高度,overscan 是可视区上下各多渲染的行数。像看书时只摊开当前两页,overscan 是左右各多翻半页垫着,estimateSize 是你估计这两页有多厚。
反例是以为 overscan 越大越安全。实测 6、10、20、40 四档:6 到 10 够用,20 开始能感到内存上涨,40 基本等于放弃虚拟滚动——首屏渲染的元素数和滚动白屏时间都回去了。
更新成本:稳定 key 与薄行组件
Vue 在比对子节点时靠 key 判断"这个节点还是原来那个吗"。key 稳定,节点就复用,只改变化的文本;key 不稳定,Vue 会重建 DOM。key 像座位号,座位号不变,换个人坐下只需换内容;座位号每轮重排,所有人都得站起来重新找位置。
反例是用数组下标当 key。列表排序之后,Vue 会把第 3 行的组件复用到第 7 行,备注输入框里的文字跟着串行——用户在第 3 行输入的字,排序后跑到了第 7 行。这类问题只在操作后出现,测试很难覆盖,只能靠规范。
动手实践
第一步:先录一条基线
打开 DevTools 的 Performance 面板,CPU 选 4× 或 6× 降速,录制"进入列表 + 快速滚动三屏"。这一步不做,后面所有优化都无法归因。
// utils/perf.ts —— web-vitals 6.x + PerformanceObserver
import { onINP } from 'web-vitals'
onINP((metric) => {
// INP good ≤ 200ms / poor > 500ms,超出阈值再上报,避免噪声
if (metric.value > 200) {
navigator.sendBeacon('/api/rum', JSON.stringify({
name: metric.name, value: metric.value, id: metric.id,
}))
}
})
const observer = new PerformanceObserver((list) => {
for (const entry of list.getEntries()) {
// 长任务阈值 50ms,超过就说明这一帧已经保不住了
if (entry.duration > 50) console.warn('longtask', entry.duration, entry.name)
}
})
observer.observe({ type: 'longtask', buffered: true })预期输出:控制台按滚动节奏打出若干条 longtask 记录,一万二千行全量渲染时单条可达数百毫秒;/api/rum 在 INP 超过 200 毫秒时收到上报。注意 buffered: true 会把页面加载期的任务也吐出来,上线第一周告警量虚高两三倍是常见的,要加时间窗过滤。
第二步:上虚拟滚动,options 必须是响应式的
<!-- app/components/VirtualOrderList.vue —— @tanstack/vue-virtual 3.13.x -->
<script setup lang="ts">
import { computed, ref } from 'vue'
import { useVirtualizer } from '@tanstack/vue-virtual'
import type { Order } from '~/types'
const props = defineProps<{ rows: Order[] }>()
const scroller = ref<HTMLElement | null>(null)
// options 用 computed 包住:换页导致 rows 变化时 count 会跟着更新
const virtualizer = useVirtualizer(computed(() => ({
count: props.rows.length,
getScrollElement: () => scroller.value,
estimateSize: () => 56,
overscan: 6,
getItemKey: (i: number) => props.rows[i]!.id,
})))
const items = computed(() => virtualizer.value.getVirtualItems())
const totalSize = computed(() => virtualizer.value.getTotalSize())
</script>
<template>
<div ref="scroller" class="scroller">
<div class="phantom" :style="{ height: `${totalSize}px` }">
<div v-for="item in items" :key="item.key" class="row"
:style="{ transform: `translateY(${item.start}px)` }">
<OrderRow :order="rows[item.index]!" />
</div>
</div>
</div>
</template>
<style scoped>
/* contain: strict 把布局与绘制限制在容器内 */
.scroller { height: 600px; overflow: auto; contain: strict; }
.phantom { position: relative; }
.row { position: absolute; inset-inline: 0; height: 56px; }
</style>预期输出:DOM 里同时存在的行数降到二十几行,滚动时 Scripting 占比明显下降。如果写成普通对象而不是 computed,会撞上一个很难查的问题:翻到第二页只能滚到第一页的底部,因为 count 停在首次渲染的数值,虚拟器不知道行数变了。这个 bug 不报错、不告警,只是滚不到底。
第三步:动态行高要挂测量函数
第二周遇到第二个问题:折叠展开备注后,越往后滚偏移越大,滚到第 800 行附近内容整片错位。estimateSize 只是估算,真实行高变化时必须让虚拟器测量每一行,并在元素上标明序号。
<!-- 行容器上补两处,偏移才会被修正 -->
<div
:data-index="item.index"
:ref="virtualizer.value.measureElement"
class="row"
>运行结果:展开备注后滚动条不再回跳,滚到第 800 行时内容与行号仍然对齐;不挂 measureElement 时,展开的行越多,累计偏移误差越大。
第四步:翻页用缓存接住
一万行即使渲染得再快,网络传输、JSON 解析、数组构建的成本还在。分页是把数据量也降下来的唯一手段。四种策略的取舍:
| 策略 | 首屏 DOM 数 | 内存 | 实现成本 | 适用 |
|---|---|---|---|---|
| 全量直出 | 万级 | 高 | 最低 | ≤ 500 行 |
| 纯分页 | 一页行数 | 低 | 低 | 后台表格、要精确跳页 |
| 无限滚动 | 可视区 | 中,持续增长 | 中 | 信息流、时间线 |
| 虚拟滚动 + 分页 | 可视区 | 低 | 高 | 万级且要保留滚动位置 |
翻页的体验问题用缓存解决:切页时保留上一页、相邻页预取、返回列表时恢复滚动位置。@tanstack/vue-query 的两个参数把前两件一次做完。
// composables/useOrderPage.ts —— @tanstack/vue-query 5.107.x
import { computed, type Ref } from 'vue'
import { keepPreviousData, useQuery } from '@tanstack/vue-query'
export function useOrderPage(page: Ref<number>) {
return useQuery({
queryKey: computed(() => ['orders', page.value]), // 必须响应式,否则翻页不触发
queryFn: () => fetch(`/api/orders?page=${page.value}&size=50`).then(r => r.json()),
placeholderData: keepPreviousData, // 翻页先显示上一页,避免表格闪空
staleTime: 60_000, // 1 分钟内回到同一页直接吃缓存
})
}预期输出:切回访问过的页面时 Network 面板里没有新请求,表格不闪空;queryKey 写成普通数组时,翻页不会触发新请求,永远显示第一页。
代价在后面。缓存里存的是分页数据,虚拟滚动要的是连续数组,两者拼一起时必须保证 index 映射稳定,否则恢复滚动位置会错行。这个项目最后放弃了组合方案,改成"虚拟滚动只在一页内生效,翻页时重置滚动位置"。体验上有让步,但正确性优先。
常见误解
其一,以为 Vue 3.6 的 Vapor 模式能解决长列表。截至 2026 年 11 月它还在 RC,而且就算稳定,一万行依然是一万个 DOM 节点,首次挂载的样式计算与布局开销不会因为跳过 diff 而消失。Vapor 的收益更可能出现在行内交互(展开、编辑、拖拽),不在首屏。
其二,以为 shallowRef 包一层大数组就安全了。包上之后行内任何字段的修改都不会触发更新——行内"标记已读"就这么失效过一次。另外 reactive 会把每个对象的每个属性都转成代理,字段越多内存与初始化越贵,纯展示的大数组该用 shallowRef,但要知道自己放弃了什么。
其三,以为优化完就该开庆功会。第一轮优化结束后没有留下基线,三个月后加了个"显示运费明细"的字段,列表又卡了,却没人知道是哪一版开始退化的。后来在 CI 里加了一个固定数据集的滚动基准,发版前后各跑一次,记录长任务数量与总阻塞时间。数字不必精确,能看出趋势就够。
小结
《组件库与设计系统:从零封装可复用组件》把组件做小,这一章说明组件变小并不等于页面变快。五条要点:
- 卡顿先分三类:节点太多、更新太多、数据太多。顺序不能颠倒,跳过前两步做分页,节点数一点没变。
- Performance 面板看三个信号:Long Task 数量、Scripting 占比、Rendering / Painting 占比。把 INP 混进来一起看,只会得到"到处都红"。
- 虚拟滚动的核心是窗口计算与
estimateSize,行高会变就必须挂measureElement加data-index,否则越滚越歪。 - 虚拟滚动的
options必须是computed,否则count停在首屏值,表现为"翻页后滚不到底",且不报错。 - key 用稳定业务 ID,行组件要薄,内联对象或数组 props 会把"每帧强制更新"写进代码里。
- 优化的结束标志不是感觉变快,而是一条可重复跑的基线。
相关主题
性能问题能定位、能验证之后,下一个风险是改动本身:今天为了让列表快一点写的 v-memo、shallowRef,明天可能被谁改回去。《测试与质量:Vitest 组件测试与 Playwright E2E》用 Vitest 与 Playwright 把这些约束写进自动化门禁。