
直接用 VirtualizingStackPanel 替换默认布局容器,是 Avalonia 列表加载性能优化最有效、最常用的方式。它不依赖数据量大小,10万条消息也能秒开,关键在于“只渲染可见项”,避免一次性创建全部 UI 元素。
启用虚拟化:3行XAML搞定
只需在 ListBox 或 ItemsRepeater 中指定
VirtualizingStackPanel作为 ItemsPanel,无需改逻辑代码: 对 ListBox:
<ListBox ItemsSource="{Binding LargeDataset}">
<ListBox.ItemsPanel>
<ItemsPanelTemplate>
<VirtualizingStackPanel CacheLength="0.5"/>
</ItemsPanelTemplate>
</ListBox.ItemsPanel>
</ListBox><ItemsRepeater Items="{Binding Items}" VirtualizationMode="Standard">
<ItemsRepeater.ItemsPanel>
<ItemsPanelTemplate>
<VirtualizingStackPanel/>
</ItemsPanelTemplate>
</ItemsRepeater.ItemsPanel>
<ItemsRepeater.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding MyProperty}"/>
</DataTemplate>
</ItemsRepeater.ItemTemplate>
</ItemsRepeater>ObservableCollection<t></t>或实现
INotifyCollectionChanged,否则增删项时虚拟化会失效
调优 CacheLength:平衡流畅与内存
CacheLength控制视口外预加载区域的高度比例(相对于当前可视高度),直接影响滚动顺滑度和内存占用: 设为
0.3:适合内存受限场景(如 ARM 设备、低配 Linux 终端),减少预渲染,可能偶现轻微白屏 设为
0.8:桌面应用推荐值,快速滚动几乎无闪烁,内存仍可控(通常维持在 150–200 个元素内) 设为
0:仅渲染严格可视项,内存最低,但快速滚动易卡顿或闪白
配合其他关键优化点
虚拟化只是起点,还需搭配以下实践才能发挥最大效果:
ItemTemplate 尽量扁平:避免多层嵌套 Border/Grid,单个TextBlock或带简单 Icon 的
StackPanel即可 禁用透明背景:把
Background="#80FFFFFF"改成不透明色(如
#FFFFFFFF),避免 GPU 混合开销 绑定模式按需选择:静态字段用
Mode=OneTime,频繁更新字段确保
INotifyPropertyChanged只在值真变化时触发 开启布局舍入:
UseLayoutRounding="True"(加在 Window 或 UserControl 根节点),减少子像素计算
验证是否生效
加一行诊断代码,实时看 FPS 和渲染耗时:
this.AttachDevTools(); RendererDiagnostics.DebugOverlays = RendererDebugOverlays.Fps | RendererDebugOverlays.TimeGraphs;
运行后左上角会出现三色曲线图:绿色(Layout)、蓝色(Update)、红色(Render)。若 Layout+Render 长期低于 16ms,说明虚拟化已稳定工作。
基本上就这些。不用魔改框架,也不用自己写滚动逻辑,标准组件 + 合理配置,就能让十万级列表丝滑如初。
