一、核心概念与适用场景

1. 按需加载原理仅渲染当前可视区域及缓存区（cachedCount）内的数据项，滚动时动态创建/销毁组件。对比ForEach：特性ForEachLazyForEach数据加载一次性全量加载按需分批加载内存占用高（所有组件常驻内存）低（仅活跃组件保留）适用场景数据量少（<100项）长列表/复杂组件（>100项）组件复用不支持支持（节点回收复用）
2. 适用场景长列表（如聊天记录、商品列表）。瀑布流布局（结合Grid或WaterFlow容器）。高复杂度子项（如含多图、嵌套组件的列表项）。

二、接口与关键参数

LazyForEach(
  dataSource: IDataSource,            // 数据源（需实现IDataSource接口）
  itemGenerator: (item: any) => void, // 子组件生成函数
  keyGenerator?: (item: any) => string // 【可选】键值生成函数
);

1. IDataSource接口必须实现的方法：totalCount(): 返回数据总量。getData(index: number): 获取索引对应数据。registerDataChangeListener(): 注册数据变更监听器。
2. 键值生成器keyGenerator：必须为每个数据项生成唯一键值（如item.id），避免使用JSON.stringify（性能损耗大）。未正确设置时，可能导致：组件复用失效 → 列表滚动卡顿。数据更新时渲染错乱（如重复键值造成组件忽略）。
3. itemGenerator限制：每次迭代必须且只能生成一个子组件。内部不允许嵌套LazyForEach或ForEach。

三、性能优化实践

1. 缓存策略cachedCount设置预加载数量（如List().cachedCount(5)），减少滚动白屏概率。示例：List({ space: 10 }).cachedCount(3) 预加载3屏数据。
2. 避免键值生成陷阱反例：keyGenerator: item => JSON.stringify(item) → 序列化大对象导致性能骤降。正例：keyGenerator: item => item.id（唯一ID）。
3. 复杂子项优化拆分复杂ListItem为独立组件，减少单组件渲染耗时。结合@Reusable装饰器启用组件复用。
4. 分帧加载大数据使用DisplaySync分帧加载数据（如日历应用全年日期拆分到多帧渲染）：// 每帧加载一个月数据 displaySync.on("frame", () => { if (currentMonth <= 12) { dataSource.pushData(loadMonthData(currentMonth)); currentMonth++; } });

四、常见问题与解决

五、最佳实践总结

1. 数据源管理：实现完整IDataSource接口，通过notifyDataAdd/Change()触发更新。
2. 键值生成：始终提供简洁的唯一键（如数据库ID），禁止使用非稳定键值（如数组索引）。
3. 容器限制：仅支持List、Grid、Swiper、WaterFlow容器。
4. 内存监控：长列表需绑定onDisappear事件释放资源（如图片缓存）。