4. LazyColumn 默认预加载机制：prefetchDistance 与内容缓存池工作原理

LazyColumn 的“预加载”并非随机提前绘制，而是通过两个核心抽象协同完成：prefetchDistance（预取距离）控制提前触发布局和组合的像素范围，内容缓存池（ViewPool / SubcomposeLayout 缓存）管理已创建的 Composable 实例复用。理解这两个组件的工作方式，是精准调优预加载行为的前提。

4.1 prefetchDistance：预取边界的定义

prefetchDistance 是一个像素值，表示在可视区域之外提前多远开始触发条目的组合与布局。当用户快速滑动时，预取操作会提前创建即将进入屏幕的条目，减少首次绘制空白帧。

预取距离的工作方式如下：当列表滚动偏移超过某个阈值时，LazyColumn 会将当前可见条目 + 预取距离内的所有条目标记为“需要组合”。组合后的组件被放入缓存池等待布局。

4.2 内容缓存池（ViewPool / SlotPool）

缓存池负责存储已组合但暂时不可见的条目实例。条目被移除屏幕后不会立即销毁，而是放入池中（Reusable 状态）；当新条目进入预取范围时，优先从池中取出复用，避免重新执行耗时的组合初始化。

• SlotPool（插槽池）：Compose 内部使用 SlotPool 管理每个条目的 Composable 插槽，记录位置偏移和缓存 key。
• Reusable Composables：条目出屏后并不释放 Composition，而是重置 key 并挂起，等待被相同键的条目取用。
• 缓存淘汰策略：当池内数量超过阈值（通常为可见条目数的 2-3 倍）或内存压力增大时，回收最早的条目。

4.3 预加载与缓存池协作流程

4.4 默认配置与 API 示例

在 Compose 1.5+ 中，可在 LazyColumn 构造参数中直接设置 prefetchDistance（单位：dp，内部转为像素）。

@Composable
fun OptimizedList() {
    val listState = rememberLazyListState()
    LazyColumn(
        state = listState,
        prefetchDistance = 200.dp // 显式设为 200dp，约 1.3 屏（1080p 宽度）
    ) {
        items(1000) { index ->
            ListItem(index)
        }
    }
}

若使用低版本 Compose（1.2 ~ 1.4），可通过 LazyListState 的 prefetchDistance 属性间接调整：

// Compose 1.2+ 内部实现：val prefetchDistance = listState.layoutInfo.let { info ->
    info.viewportSize.height + info.viewportSize.height / 2 // 1.5 倍
}

4.5 调试方法

• Layout Inspector 测量：抓取布局快照，观察 LazyListItemInfo 的 offset 与 size，推算预取距离是否合理。
• 日志输出预取事件：Compose 内部未提供直接日志，可覆写 LazyListState 的 scroll 回调记录偏移变化：

val state = rememberLazyListState()
LaunchedEffect(state) {
    snapshotFlow { state.firstVisibleItemIndex to state.firstVisibleItemScrollOffset }
        .collect { (index, offset) ->
            Log.d("LazyPrefetch", "Index=$index, Offset=$offset")
        }
}

4.6 性能优化清单

4.7 常见错误与诊断

• 预取后条目仍闪白 / 空白帧：检查缓存池是否被过早回收（memoryCache 不足）或预取距离小于条目实际高度。
• 滑动回弹时条目重新组合：key 不唯一导致 Compose 认为旧条目不可复用，强制新组合。
• 预取距离设置后无效果：确认使用的是 Compose 1.5+ 版本；低版本只能用 experimental 注解或内部反射。