Vue / 系统课时

列表与组件性能优化

列表与组件性能优化

本节把大型列表的性能问题拆成四个可操作点:只渲染视口附近数据、保持稳定 key、避免无意义的深层响应式代理,并用合适的组件边界隔离更新。你会得到一个可直接运行的十万行虚拟列表示例。

学习目标

  • 用固定行高虚拟列表把 DOM 数量从“数据总量”降到“视口可见量”。
  • 正确使用稳定 key 与 shallowRef,减少节点复用错误和深层响应式成本。
  • 在列表项组件化与组件数量之间做性能取舍,并用实际渲染数量验证效果。

先控制真正昂贵的量

普通 v-for 会让十万条数据对应十万个节点,首屏创建、布局和后续更新都可能变贵。虚拟列表的关键不是让数组变短,而是维护一个很高的“占位画布”,只把视口附近的几十条记录真正挂到 DOM。

虚拟列表的视口、缓冲区与完整数据关系

固定行高时,窗口起点近似为 floor(scrollTop / rowHeight);再向上下扩一点 overscan,能避免快速滚动时边缘来不及补齐。真正决定 DOM 规模的是可见窗口,而不是 rows.length。

实现一个最小虚拟列表

下面两个文件共同组成一个可运行示例。shallowRef 只追踪数组引用,不为十万条记录递归建立深层响应式代理;列表项使用业务主键 row.id 作为稳定 key;RowItem 组件把单行渲染边界独立出来,而虚拟化又把同时存在的组件数限制在几十个。

App.vue:

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:

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>

预期结果

text
页面可滚动浏览 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 保持节点身份正确,且响应式模型与实际变更方式一致时,这套优化才算成立。虚拟化解决“数量”,稳定身份解决“复用”,浅响应解决“代理深度”,组件边界解决“更新范围”,四者不要互相替代。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

列表与组件性能优化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通