Jetpack Compose中如何将自定义对象的mutableStateList持久存储到设备

优先选择Jetpack DataStore + Kotlinx Serialization实现轻量持久化，该方案适配你当前的简单列表存取场景，实现成本低、性能稳定，没有SharedPreferences的ANR隐患。如果后续需要支持复杂查询、分页加载等需求，可替换为Room数据库。

实现步骤 #

1. 新增依赖配置 #

在模块级build.gradle.kts中添加序列化插件和依赖：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    // 新增kotlin序列化插件，版本和项目kotlin版本保持一致
    id("org.jetbrains.kotlin.plugin.serialization") version "1.9.0"
}

dependencies {
    // DataStore 依赖
    implementation("androidx.datastore:datastore-preferences:1.0.0")
    // JSON序列化依赖
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")
}

2. 改造数据类支持序列化 #

给你的ToDo类添加序列化注解：

import kotlinx.serialization.Serializable

@Serializable
data class ToDo(
    val title: String,
    val description: String
)

原有DataProvider不需要修改。

3. 封装DataStore读写工具 #

给Context添加扩展方法实现列表的存取：

import androidx.datastore.preferences.core.stringPreferencesKey
import androidx.datastore.preferences.preferencesDataStore
import androidx.datastore.preferences.core.edit
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

// 初始化全局DataStore实例
val Context.todoDataStore by preferencesDataStore(name = "todo_storage")
private val TODO_LIST_KEY = stringPreferencesKey("todo_list")

// 存储Todo列表
suspend fun Context.saveTodoList(list: List<ToDo>) {
    todoDataStore.edit { pref ->
        pref[TODO_LIST_KEY] = Json.encodeToString(list)
    }
}

// 读取Todo列表，解析失败返回默认初始数据
suspend fun Context.getTodoList(): List<ToDo> {
    val jsonStr = todoDataStore.data.first()[TODO_LIST_KEY] ?: return emptyList()
    return try {
        Json.decodeFromString<List<ToDo>>(jsonStr)
    } catch (e: Exception) {
        DataProvider.listOfToDoEntries
    }
}

4. 改造Composable逻辑，实现自动同步 #

@Composable
fun TodoAppContent() {
    val context = LocalContext.current
    val todos = remember { mutableStateListOf<ToDo>() }

    // 页面首次加载时读取本地存储的列表
    LaunchedEffect(Unit) {
        val localList = context.getTodoList()
        todos.addAll(localList.ifEmpty { DataProvider.listOfToDoEntries })
    }

    // 监听列表变化，自动同步到本地存储，加500ms防抖减少IO操作
    LaunchedEffect(Unit) {
        snapshotFlow { todos.toList() }
            .debounce(500)
            .collect { latestList ->
                context.saveTodoList(latestList)
            }
    }

    // 原有增删逻辑、LazyColumn展示逻辑无需修改，直接操作todos即可自动同步存储
    // more code...
}

方案优势 #

• 不需要手动在每个增删改的位置调用存储方法，状态变化自动同步，避免漏存
• 全部操作异步执行，不会阻塞UI线程，无ANR风险
• 实现代码简单，不需要维护数据库表结构，适配轻量列表存储场景
• 后续扩展字段只需要给ToDo类新增带默认值的属性即可，向前兼容

内容的提问来源于stack exchange，提问作者kejlor