Android Compose LazyList向顶部添加条目时如何保留原有滚动位置？

问题原因 #

LazyColumn默认使用条目索引作为唯一标识，当你向列表头部插入新条目时，原有所有条目的索引都会整体+1。此时LazyColumn会维持当前首个可见索引的展示位置，导致原有内容整体被新插入的顶部条目向下挤。

解决方案 #

给每个条目设置全局唯一且稳定的key，让LazyColumn可以通过key而非索引识别条目，插入头部条目时就能自动维持原有可见条目的位置，和RecyclerView默认行为一致。

代码修改点 #

你只需要修改LazyColumn中itemsIndexed的配置，指定key参数即可，示例修改后的代码如下：

class MainActivity : ComponentActivity() {
    private val list = MutableStateFlow<List<String>>(emptyList())

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            EmptyComposeTheme {
                val items = list.collectAsState()
                Box(Modifier.fillMaxSize()) {
                    LazyColumn(
                        Modifier.fillMaxSize(),
                    ) {
                        // 核心修改：指定稳定的key，这里假设每个条目的字符串唯一，可直接用做key
                        // 如果存在重复内容，建议给条目数据类增加唯一id字段，用id作为key
                        itemsIndexed(
                            items.value,
                            key = { index, item -> item }
                        ) { index: Int, item: String ->
                            Text(item, color = MaterialTheme.colors.onSurface)
                        }
                    }
                    FloatingActionButton(onClick = {
                        val oldList = list.value.toMutableList()
                        oldList.add("New item ${oldList.size}")
                        list.value = oldList
                    }, Modifier.align(Alignment.BottomStart)) {
                       Text("Click me!")
                    }
                    FloatingActionButton(onClick = {
                        val oldList = list.value.toMutableList()
                        oldList.add(0, "New item reversed ${oldList.size}")
                        list.value = oldList
                    }, Modifier.align(Alignment.BottomEnd)) {
                        Text("Click other me!")
                    }
                }
            }
        }
    }
}

版本适配说明 #

你当前使用的Compose 1.0.1属于早期版本，如果设置key后仍未达到预期效果，建议将Compose版本升级至1.2.0及以上，官方在该版本对列表插入条目时的滚动位置保持逻辑做了专项优化，完全对齐RecyclerView的默认行为。

内容的提问来源于stack exchange，提问作者Van Linh Nguyen