<< All versions
Skill v1.0.1
currentAutomated scan100/100tencentblueking/bk-bcs/virtual-list
1 files
──Details
PublishedMay 15, 2026 at 10:23 AM
Content Hashsha256:915a6b40fc011290...
Git SHA6026cf9ef3f2
Bump Typepatch
──Files
Files (1 file, 2.1 KB)
SKILL.md2.1 KBactive
SKILL.md · 73 lines · 2.1 KB
version: "1.0.1" id: perf-virtual-list name: 长列表虚拟滚动优化方案 category: performance description: 处理超过 1000 条数据的大型列表渲染时的性能优化方案,包含定高和不定高两种策略。 tags: [performance, vue3, virtual-scroll, list] updated_at: 2026-01-09
长列表虚拟滚动优化方案
当列表数据量巨大(如日志列表、审计记录,n > 1000)时,直接渲染会导致 DOM 节点过多,页面卡顿。
核心原理
只渲染当前可视区域 (Viewport) 内的元素,加上缓冲区 (Buffer) 的元素。随着滚动条滚动,动态替换 DOM 内容。
推荐方案
1. 定高列表 (Item Height Fixed)
如果每一行高度固定(例如 40px),推荐使用轻量实现。
使用方式:
html
<VirtualList :items="logList" :item-height="40" :container-height="400"><template #default="{ item }"><div class="log-item">{{ item.message }}</div></template></VirtualList>
📦 获取完整组件实现:skill://virtual-list/assets/VirtualList.vue
2. 不定高列表 (Dynamic Height)
如果列表项高度不固定(如包含展开/收起、不同长度文本),计算逻辑会变得复杂。 推荐库: vue-virtual-scroller 的 DynamicScroller 组件。
html
<template><DynamicScroller:items="items":min-item-size="54"class="scroller"><template #default="{ item, index, active }"><DynamicScrollerItem:item="item":active="active":size-dependencies="[item.message,]":data-index="index"><div class="message">{{ item.message }}</div></DynamicScrollerItem></template></DynamicScroller></template>
注意事项
- 滚动白屏: 滚动过快时可能出现瞬间白屏,适当增加
buffer缓冲区大小。 - 搜索/筛选: 虚拟列表与搜索过滤不冲突,只需对
props.items进行 computed 过滤即可。
📦 可用资源
skill://virtual-list/assets/VirtualList.vue
根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载