3. DataStore 两种变体详解：Preferences DataStore 与 Proto DataStore 差异

3.1 概念解释

DataStore 是 Jetpack 提供的持久化数据存储方案，基于 Kotlin 协程和 Flow，天然支持异步、事务性和一致性。DataStore 提供两种变体：Preferences DataStore 和 Proto DataStore。它们共享相同的底层架构——轻量级、非阻塞、避免 SP（SharedPreferences）的同步与异常缺陷，但在数据模型、类型安全、性能特性上存在根本性差异。

• Preferences DataStore：直接以键值对（Key-Value）形式存储数据，使用预定义的 Preferences 类和 stringPreferencesKey()、intPreferencesKey() 等静态函数定义键。无需定义数据模型，简单直观，适合存储简单的用户设置（如开关状态、字符串配置）。
• Proto DataStore：基于 Protocol Buffers（protobuf）的强类型存储方案。需要预定义 .proto 文件生成 Java/Kotlin 类，读写时经过 protobuf 序列化/反序列化。提供类型安全、自动生成代码、对复杂结构化数据（如嵌套对象、枚举、列表）有更好支持。

3.2 流程拆解：如何选择两种变体

选择过程可拆解为三个核心步骤：需求评估 → 模型复杂度判断 → 性能与维护权衡。下面以决策流程展示。

3.3 案例分析

场景一：App 用户偏好设置（主题、通知开关、语言）

• 使用 Preferences DataStore：代码简洁，无需额外 Schema，键值对直接定义。

// 定义键
val THEME_KEY = booleanPreferencesKey("dark_mode")
val LANGUAGE_KEY = stringPreferencesKey("language")

// 写入
dataStore.edit { prefs ->
    prefs[THEME_KEY] = true
    prefs[LANGUAGE_KEY] = "zh"
}

// 读取
val themeFlow: Flow<Boolean?> = dataStore.data.map { prefs ->
    prefs[THEME_KEY]
}

场景二：用户设备配置对象（包含多个属性、嵌套设备信息、枚举状态）

• 必须使用 Proto DataStore：在 .proto 文件中定义消息结构，自动生成 Kotlin 数据类，保证类型安全和一致性。

// user_config.proto
syntax = "proto3";

message UserConfig {
  string nickname = 1;
  int32 age = 2;
  DeviceType device_type = 3;
  repeated NotificationPrefs notifications = 4;
}

enum DeviceType {
  MOBILE = 0;
  TABLET = 1;
}

message NotificationPrefs {
  string channel = 1;
  bool enabled = 2;
}

// 使用 Proto DataStore
val userConfigFlow: Flow<UserConfig> = userConfigDataStore.data
userConfigDataStore.updateData { currentConfig ->
    currentConfig.toBuilder()
        .setNickname("NewName")
        .setAge(30)
        .build()
}

3.4 表格总结：Preferences DataStore 与 Proto DataStore 全面对比

3.5 实践清单

• ✅ 优先使用 Preferences DataStore 存储简单偏好（不超过 5 个键值对，无嵌套结构）。
• ✅ 当数据需要类型安全、多字段嵌套、或未来可能增加字段时，选择 Proto DataStore 并从项目初期定义 .proto 文件。
• ✅ 在 Proto DataStore 中谨慎设计字段编号，避免未来字段重编号造成兼容性问题。
• ✅ 团队无 protobuf 经验、且项目只需要几个布尔/字符串开关时，使用 Preferences DataStore 以降低维护成本。
• ✅ 对读性能敏感的场景（频繁读取，如列表项显示），Preferences DataStore 的读取延迟更低。
• ❌ 不要在 Preferences DataStore 中存储序列化后的 JSON 字符串来模拟结构化数据，会丧失类型安全和可维护性。
• ❌ 不要为 Proto DataStore 定义过于庞大的消息，单次更新是全量读写，大数据量可能影响性能。