Compose 修改 MutableList 后界面不刷新：让列表变化进入可观察状态

点击按钮后，调试器里的列表已经增加了元素，LazyColumn 却没有新行；切到其他页面再回来，数据又出现了。若列表来自 remember { mutableListOf(...) }，先检查修改是否经过 Compose 能观察的状态对象。remember 会保留对象，但不会把普通列表的每次修改变成状态通知。

下文针对 Jetpack Compose 1.x 的状态 API，示例使用 Kotlin 和 Material 3，假定项目已有匹配的 Compose Runtime、Foundation、Material 3 依赖。这是状态更新方式的问题，不依赖某个 Android targetSdk，也不需要通过升级系统解决。

看清楚写入的是列表，还是 State.value

下面两种写法都容易留下旧界面：

// 普通 MutableList 的 add 不会成为 Compose 状态写入。
val names = remember { mutableListOf("A") }
// 在点击回调中执行：names.add("B")

// 外面包一层 State，也不会自动观察内部列表的 add。
val wrapped = remember { mutableStateOf(mutableListOf("A")) }
// 在点击回调中执行：wrapped.value.add("B")

第二种写法修改了 wrapped.value 指向的对象内部，未给 value 提交新的列表状态。即使再把同一对象赋回去，也不能把已经发生的原地修改补成一份可靠的“旧值与新值”。默认的 mutableStateOf 使用结构相等判断；不能简单理解成“每赋值一次就一定重组”。

还要看初始化代码的位置。remember 后面若每次都执行 clear()、addAll()，一旦其他状态触发重组，用户刚修改的结果可能被初始化逻辑清空。初始值应放在 remember 的计算块中，后续变化则由事件或明确的数据更新入口负责。

用只读列表表示一次完整状态

如果页面已经采用“当前状态加事件”的方式，保留一份 List，修改时创建新列表通常更容易检查。下面是可放进既有 Compose 页面调用的完整组件：

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue

data class TaskRow(
    val id: Int,
    val title: String,
    val done: Boolean = false
)

@Composable
fun TaskListExample() {
    var tasks by remember {
        mutableStateOf(listOf(TaskRow(1, "检查日志")))
    }

    Column {
        Button(onClick = {
            val nextId = (tasks.maxOfOrNull { it.id } ?: 0) + 1
            tasks = tasks + TaskRow(nextId, "任务 $nextId")
        }) {
            Text("添加")
        }

        LazyColumn {
            items(tasks, key = { it.id }) { task ->
                Button(onClick = {
                    tasks = tasks.map { row ->
                        if (row.id == task.id) {
                            row.copy(done = !row.done)
                        } else {
                            row
                        }
                    }
                }) {
                    Text("${task.title}：${if (task.done) "完成" else "待办"}")
                }
            }
        }
    }
}

添加时给 tasks 赋新列表；修改一行时用 copy 创建新元素，再提交新列表。其他元素可以继续复用，因为示例模型的属性都是 val，后续没有其他地方原地修改它们。

Kotlin 的 List 是只读接口，并不保证底层对象永远不可变。如果先把一份 MutableList 当作 List 暴露出去，又从其他引用修改它，仍会破坏这种状态约定。要同时检查列表的创建、暴露和修改入口。

页面局部列表也可以用 mutableStateListOf

如果组件需要直接增删列表，可用 mutableStateListOf 创建 SnapshotStateList。它能观察列表操作：

import androidx.compose.runtime.mutableStateListOf

// 放在 Composable 内；TaskRow 沿用前面的不可变模型。
val tasks = remember {
    mutableStateListOf(TaskRow(1, "检查日志"))
}

// 放在点击等事件回调中：
tasks.add(TaskRow(2, "查看结果"))
tasks[0] = tasks[0].copy(done = true)

这段代码展示另一条状态管理路径，替换前面的列表声明和更新逻辑使用，不要让两份列表同时充当页面的数据源。若添加功能可以反复调用，ID 也要像完整示例那样生成，不能重复使用示例里的 2。

SnapshotStateList 观察的是列表变化，不会递归观察元素的所有普通属性。若模型声明了 var done: Boolean，直接执行 tasks[0].done = true 仍可能没有状态通知；使用不可变元素并替换相应位置，或把确实需要独立观察的属性设计为状态。

数据由 ViewModel 的 Flow 提供时，应在那条数据流中提交新状态，并在界面收集它。不要另外 remember 一份可变副本后只改副本，否则服务端刷新和本地点击会各自维护不同的数据。

改完后如何判断问题已经解决

在页面停留期间连续添加、切换同一行的完成状态，界面应随每次有效状态变化更新，无需靠滚动、切页或修改无关变量触发刷新。再让父组件发生一次无关重组，列表也不应被 clear() 或初始化循环重置。

如果数据源已经更新而界面仍旧，继续检查 LazyColumn 实际读取的是否是同一个状态，以及是否存在无 key 的 remember { incomingList } 固定了最初参数。添加 @Stable、更换行 key 或设置额外“刷新计数器”都不能补上遗漏的状态写入。

这里的 remember 只保留当前 Composition 中的状态。页面退出、配置变化或进程重建后的恢复需求，需要另行选择 ViewModel、rememberSaveable 或持久化存储。采用上述修复不会自动保存数据；回退代码前也应保留已经完成的业务写入，不能把重新初始化列表当成数据恢复。