1. 认识 DataStore：用途、两种实现与适用场景

Jetpack DataStore 是 Android 官方推出的轻量级本地数据存储解决方案，旨在替代 SharedPreferences，提供异步、一致且类型安全的键值存储与结构化数据持久化能力。它基于 Kotlin 协程和 Flow（数据流）构建，天然支持反应式编程与生命周期安全。

1.1 核心用途

• 持久化应用设置与偏好：如主题、语言、通知开关等轻度用户配置。
• 小型结构化数据缓存：如最近使用的项目列表、登录状态标志。
• 单进程内数据共享：同一 App 内多个组件通过 Flow 观察数据变化，实现实时同步。
• 替代 SharedPreferences 线程安全与异常问题：DataStore 确保主线程安全，并支持 try-catch 处理序列化/反序列化异常。

1.2 原理概述

DataStore 以文件形式将数据持久化到设备内部存储。读取时返回 Flow<T>，数据变更时会自动发射新值；写入操作通过挂起函数 updateData() 或 edit() 实现事务性修改。整个读写过程由协程调度，避免阻塞主线程。

1.3 两种实现对比

1.4 适用场景决策流程

1.5 依赖引入与基础配置

在 build.gradle.kts（模块级）添加对应依赖：

// Preferences DataStore
implementation("androidx.datastore:datastore-preferences:1.1.1")

// Proto DataStore（需要额外配置 protobuf 插件）
implementation("androidx.datastore:datastore:1.1.1")
// 还需要在 build.gradle.kts 中配置 protobuf 插件和定义 .proto 文件

1.6 常见错误与稳定性优化

• 在非协程作用域调用写入方法：必须处于协程上下文中，否则编译报错。
• 文件损坏导致读取异常：DataStore 内部使用事务日志，但极端情况仍可抛出 CorruptionException，建议在外层 catch 后重建。
• 跨进程共享不可靠：DataStore 本身不支持多进程并发，需要跨进程应在 ContentProvider 或自定义 Service 中封装。
• 高频写操作合并：DataStore 会合并 5 秒内的连续写入为一次磁盘操作，避免频繁 I/O 抖动。
• 使用 dataStore.data 的 collect 时注意取消：配合 repeatOnLifecycle 或 flowWithLifecycle 防止生命周期泄露。