Vue / 系统课时
列表与组件性能优化
列表与组件性能优化
本节把大型列表的性能问题拆成四个可操作点:只渲染视口附近数据、保持稳定 key、避免无意义的深层响应式代理,并用合适的组件边界隔离更新。你会得到一个可直接运行的十万行虚拟列表示例。
学习目标
- 用固定行高虚拟列表把 DOM 数量从“数据总量”降到“视口可见量”。
- 正确使用稳定
key与shallowRef,减少节点复用错误和深层响应式成本。 - 在列表项组件化与组件数量之间做性能取舍,并用实际渲染数量验证效果。
先控制真正昂贵的量
普通 v-for 会让十万条数据对应十万个节点,首屏创建、布局和后续更新都可能变贵。虚拟列表的关键不是让数组变短,而是维护一个很高的“占位画布”,只把视口附近的几十条记录真正挂到 DOM。

固定行高时,窗口起点近似为 floor(scrollTop / rowHeight);再向上下扩一点 overscan,能避免快速滚动时边缘来不及补齐。真正决定 DOM 规模的是可见窗口,而不是 rows.length。
实现一个最小虚拟列表
下面两个文件共同组成一个可运行示例。shallowRef 只追踪数组引用,不为十万条记录递归建立深层响应式代理;列表项使用业务主键 row.id 作为稳定 key;RowItem 组件把单行渲染边界独立出来,而虚拟化又把同时存在的组件数限制在几十个。
App.vue:
<script setup lang="ts">
import { computed, ref, shallowRef } from 'vue'
import RowItem from './RowItem.vue'
interface Row {
id: number
name: string
}
const rowHeight = 36
const viewportHeight = 480
const overscan = 6
const scrollTop = ref(0)
// 数据整体替换时才需要响应式,单条记录本身保持普通对象。
const rows = shallowRef<Row[]>(
Array.from({ length: 100_000 }, (_, index) => ({
id: index + 1,
name: `Row ${index + 1}`,
})),
)
const start = computed(() =>
Math.max(0, Math.floor(scrollTop.value / rowHeight) - overscan),
)
const visibleCount = Math.ceil(viewportHeight / rowHeight) + overscan * 2
const visibleRows = computed(() =>
rows.value
.slice(start.value, start.value + visibleCount)
.map((row, index) => ({
row,
top: (start.value + index) * rowHeight,
})),
)
const totalHeight = computed(() => rows.value.length * rowHeight)
function onScroll(event: Event): void {
scrollTop.value = (event.currentTarget as HTMLElement).scrollTop
}
</script>
<template>
<div
class="viewport"
:style="{ height: `${viewportHeight}px` }"
@scroll="onScroll"
>
<div class="stage" :style="{ height: `${totalHeight}px` }">
<RowItem
v-for="item in visibleRows"
:key="item.row.id"
:row="item.row"
:top="item.top"
:height="rowHeight"
/>
</div>
</div>
</template>
<style scoped>
.viewport {
overflow: auto;
border: 1px solid #ccc;
}
.stage {
position: relative;
}
</style>RowItem.vue:
<script setup lang="ts">
interface Row {
id: number
name: string
}
defineProps<{
row: Row
top: number
height: number
}>()
</script>
<template>
<div
class="row"
:style="{ transform: `translateY(${top}px)`, height: `${height}px` }"
>
{{ row.id }} · {{ row.name }}
</div>
</template>
<style scoped>
.row {
position: absolute;
left: 0;
right: 0;
box-sizing: border-box;
padding: 8px 12px;
border-bottom: 1px solid #eee;
}
</style>预期结果
页面可滚动浏览 100000 条记录,但任意时刻只渲染“视口行数 + 上下缓冲”的几十个 RowItem 组件。
滚动时内容连续,行号与名称保持对应;DOM 数量不会随 rows.length 增长到 100000。实际可见数量会随视口高度、行高和 overscan 变化。固定行高是这个最小实现的前提;如果每行高度不确定,需要额外的高度测量与偏移缓存,不能直接套用这里的公式。
稳定 key 和浅响应各解决什么
稳定 key 解决的是节点身份问题。排序、插入或删除后,Vue 可以继续把同一个 row.id 对应到同一个列表项;用数组下标做 key,位置变化时可能导致错误复用,也会让局部更新更难预测。
shallowRef 解决的是响应式深度问题。它适合“数据很多,但内部对象基本只读,通常整体替换”的场景。若你直接修改 rows.value[0].name,Vue 不会因为这次深层修改自动触发依赖更新;需要深层可变状态时,应改用普通 ref/reactive,或把可变状态单独建模。
组件拆分要和虚拟化一起看
把每一行拆成组件,能够让 props 边界更清楚,也便于把复杂行内容的更新限制在自身。但如果仍一次挂载十万个行组件,组件拆分本身不会解决总量问题,甚至会增加实例创建成本。
更稳妥的顺序是先减少同时渲染的数量,再让行组件保持输入稳定。对于只展示文本的极简单行,内联模板也可能更快;对于含头像、状态、按钮或局部交互的复杂行,独立组件通常更利于隔离更新和维护。
用数据而不是感觉验收
验收时至少看三件事:滚动时是否保持连续、DOM/组件数量是否维持在小窗口范围、一次数据更新是否只影响必要行。再用 Performance 面板录制相同滚动距离,对比脚本、样式计算和布局耗时。
当列表总量继续增长而页面 DOM 规模基本不变,稳定 key 保持节点身份正确,且响应式模型与实际变更方式一致时,这套优化才算成立。虚拟化解决“数量”,稳定身份解决“复用”,浅响应解决“代理深度”,组件边界解决“更新范围”,四者不要互相替代。