同一份 10000 条订单数据,全量渲染会生成 10000 个行节点,页面总 DOM 到 120010 个。
切到虚拟列表,只保留可视区 14 行加上下各 5 行缓冲,滚动时实际行 DOM 稳定在 24 个,总 DOM 299 个。
我在这台 Windows 机器上用 Chrome 连跑三轮滚动测试:全量 31.732.3 FPS,虚拟列表 60.360.7 FPS。
页面里的 10 条断言全 PASS,滚动位置、首行序号、滚动高度都能当场核对。

公开仓库在 Demo Park,单个 index.html,双击就能开。
仓库地址:gitcode.com/OPCTeam/dem...
一、先看结果:10000 行和 24 行差在哪
我把同一份数据交给两种渲染方式,参数固定:10000 条、行高 44px、可视区 616px。
全量模式一次建 10000 个 .row,每个行里有 10 个单元格,加上表头和容器,总 DOM 120010 个。
虚拟模式只建 24 个 .row,总 DOM 299 个。
首屏渲染耗时,全量 72ms,虚拟 10ms。
滚动测试更能说明问题。
同一页连跑三轮,每轮自动滚动 3 秒,从顶部滚到底部。
| 指标 | 全量渲染 | 虚拟列表 |
|---|---|---|
| 行 DOM 数 | 10000 | 24(底部 19~21) |
| 总 DOM 数 | 120010 | 299 |
| 首屏渲染耗时 | 72ms | 10ms |
| 3 秒总帧数 | 95~97 | 181~182 |
| 平均帧间隔 | 31.6~32.1ms | 16.7ms |
| P95 帧间隔 | 34.1~34.4ms | 17.2~17.6ms |
| 实测 FPS | 31.7~32.3 | 60.3~60.7 |
| 掉帧数(>16.7ms) | 90~93 | 53~70 |
第一次打开全量页时,滚动测试跑出过 42.3 FPS。
同一页继续跑第二、第三轮,数字掉到 32 FPS 左右。
虚拟列表三轮都贴着 60 FPS。
这里比的不是「谁先把数据读完」,是「浏览器每帧要维护多少个节点」。
10000 条数据本身不大,10000 个 DOM 才大。
二、为什么全量渲染会卡:浏览器维护的是节点,不是数组
一条订单在内存里就是一个对象,字段再多也就几百字节。
渲染成 DOM 后,它变成一个行容器加 10 个单元格。
每个单元格都有自己的样式、布局盒和文本节点。
10000 行乘下来,就是十万级节点。
浏览器滚动时不用重新创建这些节点,但要做样式计算、布局和合成。
节点越多,每帧要扫的东西越多。
全量页的滚动测试里,平均帧间隔 31.6ms,P95 到 34.4ms。
60Hz 屏幕一帧只有 16.7ms,31ms 已经掉到 30 FPS 档。
虚拟列表只保留 24 行,浏览器每帧面对的节点少了三个数量级。
所以它能稳定在 16.7ms 一帧。
我把滚动位置拖到 200000px,虚拟列表首行序号变成 4541,页面里仍然只有 24 行。
这说明省下来的不是数据,是 DOM。

三、虚拟列表怎么算:一个除法加两段缓冲
核心只有三个数:滚动距离、行高、可视区高度。
可视区 616px,行高 44px,一屏能放 14 行。
我在上下各留 5 行缓冲,窗口总行数就是 14 + 5 + 5 = 24。
滚动时先算起点:
startIndex = max(0, floor(scrollTop / rowHeight) - 5)
再算终点:
endIndex = min(10000, startIndex + 24)
列表主体高度固定写成 10000 × 44 = 440000px。
真正的 24 行放进一个绝对定位窗口,窗口顶部等于 startIndex × 44。
这样滚动条的长度一直不变,用户拖动时不会跳。
到底部时,下面的缓冲没有数据,实际只剩 19~21 行。
这不是 bug,是边界。
| 参数 | 值 | 作用 |
|---|---|---|
| 数据量 | 10000 | 总行数 |
| 行高 | 44px | 固定行高,定位公式的前提 |
| 可视区 | 616px | 一屏 14 行 |
| 上下缓冲 | 各 5 行 | 快速滚动时不露白 |
| 窗口行数 | 24 | 14 可视 + 10 缓冲 |
| 主体高度 | 440000px | 撑住滚动条 |
公式不难,难的是浏览器会在你清空列表时动手脚。

四、我在码道里怎么把它做出来
码道有三种使用方式:WebUI(浏览器对话)、TUI(终端命令行)和桌面 IDE(IDE 插件)。
本文用 WebUI 版生成。
我给它的需求很具体:单文件、无外部依赖、左边列表、右边指标、10 条页内断言、一个失败路径。
它还要求滚动测试必须用 requestAnimationFrame 真实统计 3 秒,不能写死数字。
第一次交付的 index.html 约 26KB,双击能开,没有 CDN。
界面基本对,但有四个地方我返工了。
第一,缓冲行数原本按可视行数的一半算,14 行变成上下各 7 行,窗口是 28 行。
标题写的是 24,实际渲染 28,对不上。
我把缓冲改成固定 5 行,窗口才稳定在 24。
第二,自检第 2 条写的是「虚拟模式下行 DOM 数在 24±6」,但全量模式下直接 return true。
截图里全量 10000 行也显示 PASS,读者一眼就会觉得假。
我把它改成检查窗口配置,并显示当前模式和实际行数。
第三,第 7 条「行 DOM 数与模式匹配」也有同样的条件短路。
我改成全量必须等于 10000,虚拟必须在 18~30 之间。
第四,失败提示原来挤在顶栏右侧,13px 红字。
截图里几乎看不见。
我把它改成底部居中的红色浮层,错误原因和回退结果都能读清。
这些都不是算法问题,是交付品控。
五、踩到的真坑:清空列表时 scrollTop 被夹回 0
改完缓冲后,我拖滚动条到 200000px,页面仍然显示第 1~24 行。
自检第 5 条直接 FAIL:scrollTop 是 200000,firstRowIdx 还是 1。
我先把 renderVirtual 拆开看。
它每次先 body.innerHTML = '',再拼 24 行,再写回去。
问题就在这一行。
列表主体原本靠上下 padding 撑到 440000px。
清空的一瞬间,主体高度变成 0,滚动容器的高度也跟着塌。
浏览器发现滚动位置超过可滚动范围,把 container.scrollTop 夹回 0。
等 24 行重新写进去,滚动位置已经是 0 了。
所以 startIndex 永远按 0 算,虚拟列表只渲染前 24 行。
我试过一个偷懒的修法:重建后把 scrollTop 写回原值。
测试还是 FAIL。
因为清空时已经被夹到 0,后面再触发一次 scroll 事件,又从 0 算一遍。
真正的修法是把主体高度和渲染窗口分开。
先给 body.style.height 写成 10000 × 44,再清空内容。
24 行放进绝对定位窗口,窗口的 top 等于 startIndex × 44。
这样清空时滚动高度不塌,scrollTop 不会被浏览器改。
修完再拖到 200000px,首行变成 4541。
拖到底部 439384px,首行变成 9982,行 DOM 19 个。
自检第 5 条也 PASS 了。
另一个小坑是断言刷新。
滚动时只更新指标,不重跑断言,截图里的 scrollTop 还停在 0。
我加了 120ms 防抖,滚动停下来再重跑断言。
这样既不会每帧重建 10 条断言,也不会显示过期数字。

六、实测方法:3 秒自动滚动,记的是帧间隔
测试逻辑不复杂。
点击「开始滚动测试」后,页面把列表滚回顶部。
接下来 3 秒,用 requestAnimationFrame 每帧把 scrollTop 推到 progress × 最大滚动距离。
同时记下每一帧的时间戳。
结束后算四个数:总帧数、平均帧间隔、P95 帧间隔、掉帧数。
掉帧阈值我设成 16.7ms。
这个阈值很严。
60Hz 下正常帧就是 16.7ms,稍微抖一点就会记一次掉帧。
所以虚拟列表也有 53~70 次「掉帧」,但平均帧间隔仍是 16.7ms,P95 只有 17.6ms。
看流畅度不能只数掉帧,要结合平均值和 P95。
全量页的 P95 是 34ms 左右,已经接近两帧。
用户拖滚动条时感受到的停顿,主要来自这里。
这套测试只测滚动帧率,不测首屏加载和内存峰值。
首屏耗时另算,全量 72ms,虚拟 10ms。
内存我没有抓,因为不同机器差异太大。
能确定的是:全量页有 120010 个 DOM,虚拟页只有 299 个。
七、三步复现:尺子、换位置、走失败路径
第一步,看尺子。
打开页面,确认行 DOM 24、总 DOM 299、自检 10/10 PASS。
第二步,换位置。
把列表拖到 200000px,首行序号应该从 1 变成 4541 左右,行 DOM 仍是 24。
拖到底部,首行接近 10000,行 DOM 降到 19~21。
第三步,走失败路径。
把行高改成 0,点「应用配置」。
底部必须弹出「行高必须 ≥ 24px;可视区高度必须 ≥ 行高」,输入框回退到 44,列表不能白屏。
三步都过,这个页面才算真能跑。

八、边界、使用码道体会与下一步
这是浏览器里的本地页面,数据由固定种子生成,不发请求,不上传文件。
数字来自这台 Windows 机器上的 Chrome,视口 1600×1000。
换一台机器、换一个浏览器,FPS 会变。
全量模式在低端手机上可能直接卡死,这恰好是它要演示的问题。
虚拟列表也不是万能。
固定行高才能用这个除法公式。
行高不固定,要改成测量缓存加前缀和,复杂度会上一个台阶。
图片、展开行、分组头混在一起时,也不能只按 44px 算。
这次没有对比 React、Vue 的虚拟列表库。
我故意用原生 DOM,把变量压到只剩「节点数量」一个。
下一步想补两件事。
一是可变行高,用测量缓存重算偏移。
二是把 10000 条换成真实接口分页,看看网络和渲染各占多少时间。
使用码道体会,我记了五条:
- 需求里先写验收数字,再写界面,返工会少很多。
- 断言必须检查真实分支,条件短路会让 PASS 变成摆设。
- 滚动容器的清空操作会改
scrollTop,这类副作用要单独测。 - 失败路径要截图验收,不能只看代码里有没有
return。 - 单文件交付最省事,读者双击就能复现。
九、准备环境:进入码道 Web
浏览器打开码道 Web 版:devcloud.cn-north-4.huaweicloud.com/chat?source...,登录后直接在对话窗口输入需求,不需要装软件。
十、仓库与复现
仓库地址:gitcode.com/OPCTeam/dem...
powershell
git clone https://gitcode.com/OPCTeam/demo_park.git
cd demo_park\codearts-virtual-list-lab
start index.html
也可以只下载 index.html 双击打开。
如果只想看结论,先点「虚拟列表 24 条」,再点「开始滚动测试」,30 秒就能看到 60 FPS 和 24 行 DOM。