虚拟列表是解决长列表渲染性能问题的方案,通过仅渲染可视区域元素、用transform定位及固定高度容器来避免dom过载,不可混用非虚拟节点,宜配合游标分页而非传统分页。

虚拟列表不是用来“配合”长列表的,它本身就是解决长列表渲染性能问题的方案。直接渲染几千条 <li> 会导致页面卡顿、内存飙升、滚动掉帧——这时候不该纠结“怎么让长列表跑得更好”,而该问:“能不能只渲染可视区域那几十条?”
为什么直接用 for 渲染长列表会卡
浏览器渲染流程中,DOM 节点数量直接影响重排(reflow)和重绘(repaint)开销。哪怕每条 <li> 只有 20 行样式,10000 条就是 10000 个 DOM 节点 + 对应的 JS 对象 + 事件监听器(如果绑了)。实际测试中,Chrome 在 3000+ 条后就明显出现滚动延迟,Safari 更敏感。
常见错误现象包括:
- 滚动时
FPS掉到 10–15,肉眼可感知卡顿 - 首次加载后内存占用突增 100MB+(尤其含图片或复杂子组件)
- 在移动端快速滑动时触发
RangeError: Maximum call stack size exceeded(因 Vue/React 的响应式依赖追踪过载)
useVirtual 或 react-window 的核心逻辑是什么
它们不操作真实 DOM 列表,而是用一个固定高度的容器(<div style="height: 500px">),靠 <code>scrollTop 和 item 高度算出当前“该显示哪几条”,再用 transform: translateY() 把这几条“摆”到正确位置。空白部分由伪元素或 padding 撑开,视觉上仍是完整列表。
关键参数必须对齐:
-
itemHeight必须是固定值(或预设高度数组),动态高度需先测量并缓存,否则无法精确定位 -
overscanCount(额外渲染条数)建议设为 5–10:太小会白屏闪烁,太大抵消性能收益 - 滚动容器必须设置
overflow-y: auto且不能是body(否则scrollTop获取不准)
示例片段(React + react-window):
import { FixedSizeList as List } from 'react-window';
<list height="{500}" itemcount="{10000}" itemsize="{48}" width="100%">
{({ index, style }) => <div style="{style}">Item {index}</div>}
</list>
长列表里混用虚拟滚动和普通渲染会出什么问题
不能混用。比如在虚拟列表中间插入一个非虚拟的 <div class="ad-banner">,会导致整个计算错乱:item 索引偏移、<code>translateY 偏差、滚动位置跳变。框架如 Vue 的 v-for + v-virtual-scroll 插件通常也不支持 slot 插入非虚拟节点。
真有广告/分组标题等“非数据项”,正确做法是:
- 把它们当作特殊
item类型,统一纳入虚拟列表的数据源(例如items = [{type: 'data', id: 1}, {type: 'banner'}, {type: 'data', id: 2}]) - 在
itemRenderer中按type分支渲染,同时确保所有 item 的itemSize可计算(banner 高度也得固定) - 避免在虚拟容器内手动
appendChild或用innerHTML注入内容——这会破坏虚拟滚动的 DOM 管理边界
服务端分页和前端虚拟列表能一起用吗
能,但没必要。虚拟列表本质是“前端分块渲染”,和服务端分页(如每次只查 20 条)目标不同:前者解决渲染压力,后者解决数据量和网络负载。如果接口本身已做分页,又强行套虚拟列表,反而增加复杂度(比如要维护滚动位置 + 分页状态同步)。
更合理的组合是:
- 数据量 ≤ 5000 条 → 全量拉取 + 前端虚拟列表(省去翻页交互)
- 数据量 ≥ 10 万条 → 后端提供游标分页(
cursor)+ 前端虚拟列表(滚动到底部自动 fetch 下一批,并追加进虚拟数据源) - 绝对避免:前端虚拟列表 + 传统
page=1&size=20分页 —— 用户快速滚动时会反复触发请求,且容易漏数据
游标分页的关键是让下一页请求携带上一页最后一条的 id 或 updated_at,而不是页码。
虚拟列表的坑不在代码多难写,而在“以为自己在优化,其实只是把问题藏得更深”:比如用了 react-virtualized 却没关掉 shouldComponentUpdate,或者给每个 item 加了独立的 useState,结果 memo 失效,重渲染成本翻倍。真正起作用的永远是那几个硬约束:固定高度、单一滚动容器、纯净的数据源结构。











