虚拟滚动处理不固定高度列表的核心是动态测量+高度缓存+位置映射;通过元素测量首次获取真实高度并存入map,构建前缀和数组offsets实现o(1)偏移计算,结合二分搜索确定可视范围,并用resizeobserver监听动态变化、节流更新缓存与offsets。

虚拟滚动处理不固定高度列表,核心是动态测量 + 高度缓存 + 位置映射,不是靠预设行高硬算。关键在于让滚动时只渲染可视区域,同时能快速知道某一项在列表中的真实偏移位置。
用 元素测量 + Map 缓存 记录每项真实高度
首次渲染可见项时,用 ref 或 getBoundingClientRect() 获取每个 DOM 元素的实际高度,并存入 Map(key 为 index)。后续滚动中,通过已缓存的高度累加,就能算出任意索引项的顶部偏移量。
- 首次进入视口的元素才触发测量,避免全量遍历
- 缓存结构推荐:
const heightMap = new Map<number number>()</number> - 若数据更新(如展开/收起、富文本重排),需清除对应 index 及之后的缓存,下次滚动到时重新测
滚动定位依赖 前缀和数组 替代逐项累加
每次滚动都要算“第 n 项距顶部多远”,如果每次都从头遍历 heightMap 累加,O(n) 复杂度会拖慢响应。更优做法是维护一个前缀和数组 offsets: number[],其中 offsets[i] 表示第 i 项(0 起)的顶部偏移,构建方式为:
offsets[0] = 0offsets[i] = offsets[i-1] + heightMap.get(i-1) || 0- 插入/删除/高度变更后,仅需局部重算 offsets(如从变更点开始往后)
可视范围计算要 双向查找 + 二分优化
给定滚动位置 scrollTop,需快速找出当前可视区域起始索引 startIndex 和结束索引 endIndex。不能线性扫描 offsets,应使用二分搜索:
- 在
offsets中找最后一个 ≤scrollTop的索引 → 得到startIndex - 再向后扩展若干项(比如 + visibleCount),确保内容撑满容器高度
- 配合
containerHeight和offsets末尾值,截断超出部分
应对动态变化:监听 resize & 内容变更,懒更新 + 节流
高度不固定常源于图片加载、折叠面板展开、Markdown 渲染完成等异步行为。此时需:
- 对关键容器(如列表项内部)使用
ResizeObserver监听尺寸变化 - 当检测到某项高度变化,仅更新该 index 的 heightMap 和 offsets 后续部分
- 所有更新操作用
requestIdleCallback或节流(如 100ms 内合并多次变更)防抖动
不复杂但容易忽略:缓存清理时机和 offsets 局部更新逻辑,往往比滚动本身更影响稳定性。只要测得准、存得对、算得快,哪怕每行高度都不同,也能保持 60fps 滚动体验。










