1. 为什么需要数据持久化在Android应用开发中数据持久化是一个基础但至关重要的概念。想象一下如果你每次打开音乐APP都要重新登录、重新设置音效偏好或者每次启动天气APP都要重新选择城市这种体验会有多糟糕。这就是为什么我们需要将某些数据记住在设备上。数据持久化本质上就是让应用能够保存关键信息即使应用被关闭或设备重启这些信息也不会丢失。Android平台提供了多种数据持久化方案每种方案都有其特定的适用场景SharedPreferences轻量级的键值对存储文件存储适用于大量结构化或非结构化数据SQLite数据库关系型数据存储方案RoomSQLite的抽象层提供更便捷的API2. SharedPreferences的核心特性2.1 基本概念与适用场景SharedPreferences是Android平台提供的一种轻量级数据存储解决方案它本质上是一个键值对(Key-Value)存储系统。最适合存储简单的配置数据和用户偏好设置比如用户的主题偏好深色/浅色模式应用的语言设置记住登录状态游戏中的玩家设置和简单进度它的数据以XML文件形式存储在设备的/data/data/package_name/shared_prefs/目录下每个SharedPreferences文件对应一个XML文件。2.2 与其它存储方案的对比特性SharedPreferences文件存储SQLite数据库存储形式键值对(XML)任意格式文件关系型数据库适合数据量小(通常1MB)中到大中到大查询复杂度简单键值查询需自行解析复杂查询支持线程安全部分API需要处理需自行处理需自行处理系统API支持度完整基础完整提示虽然SharedPreferences使用方便但当需要存储复杂数据结构或大量数据时应该考虑使用数据库方案。3. SharedPreferences的实战使用3.1 基本读写操作获取SharedPreferences实例有三种方式根据不同的使用场景选择// 1. 私有模式 - 只有当前应用可以访问 SharedPreferences prefs getSharedPreferences(my_prefs, MODE_PRIVATE); // 2. 使用默认文件名 - 等价于getSharedPreferences(PACKAGE_NAME_preferences, MODE_PRIVATE) SharedPreferences defaultPrefs PreferenceManager.getDefaultSharedPreferences(this); // 3. 从Context直接获取 SharedPreferences contextPrefs getPreferences(MODE_PRIVATE);写入数据需要使用Editor对象SharedPreferences.Editor editor prefs.edit(); editor.putString(username, john_doe); editor.putInt(login_count, 5); editor.putBoolean(dark_mode, true); editor.apply(); // 异步提交 // 或者 editor.commit(); // 同步提交返回boolean表示成功与否读取数据则直接通过SharedPreferences对象String username prefs.getString(username, default_value); int loginCount prefs.getInt(login_count, 0); boolean isDarkMode prefs.getBoolean(dark_mode, false);3.2 高级用法与最佳实践3.2.1 监听偏好变化可以注册OnSharedPreferenceChangeListener来监听特定键的变化SharedPreferences.OnSharedPreferenceChangeListener listener (sharedPreferences, key) - { if (dark_mode.equals(key)) { // 处理主题变化 updateTheme(sharedPreferences.getBoolean(key, false)); } }; prefs.registerOnSharedPreferenceChangeListener(listener); // 记得在适当时候取消注册 prefs.unregisterOnSharedPreferenceChangeListener(listener);3.2.2 多进程注意事项默认情况下SharedPreferences不支持多进程同步。如果需要在多进程间共享数据可以使用MODE_MULTI_PROCESS标志但要注意这已经过时在API 23不再保证有效。更好的方案是使用ContentProvider或其他进程间通信机制。3.2.3 性能优化技巧批量操作多次修改应该集中在一个editor中执行减少IO次数editor.putString(key1, value1) .putInt(key2, 123) .apply();选择合适的提交方式apply()异步写入无返回值更高效commit()同步写入返回boolean适合需要知道结果的场景避免存储大型数据SharedPreferences不是为存储大量数据设计的大文件应该使用文件存储或数据库4. 常见问题与解决方案4.1 数据丢失问题现象偶尔会发现保存的数据消失了。可能原因及解决方案使用了apply()但应用立即退出apply()是异步操作如果应用在写入完成前退出数据可能丢失解决方案关键数据使用commit()或确保应用不会立即退出多进程冲突多个进程同时修改同一prefs文件可能导致数据不一致解决方案避免多进程共享或使用更合适的IPC机制键名拼写错误读取时使用了错误的键名返回了默认值解决方案定义常量来管理所有键名4.2 性能问题现象当SharedPreferences文件较大时读取操作变得缓慢。优化方案拆分大的prefs文件按功能模块使用不同的prefs文件例如user_prefs.xml, settings_prefs.xml等减少自动保存频率避免在每次值变化时都保存可以在合适的时机如onPause批量保存考虑迁移到数据库当数据量超过几百KB时应该考虑使用SQLite4.3 类型安全问题问题使用错误的类型读取数据会导致运行时异常。防御性编程建议使用类型安全的封装public class PrefsHelper { private static final String PREFS_NAME my_app_prefs; public static void saveUserId(Context context, long userId) { context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE) .edit() .putLong(user_id, userId) .apply(); } public static long getUserId(Context context) { return context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE) .getLong(user_id, -1L); } }使用Kotlin的扩展函数如果项目使用Kotlinfun SharedPreferences.edit(block: SharedPreferences.Editor.() - Unit) { edit().apply(block).apply() } // 使用示例 prefs.edit { putString(name, John) putInt(age, 30) }5. SharedPreferences的现代替代方案虽然SharedPreferences简单易用但在现代Android开发中也有一些值得考虑的替代方案5.1 DataStoreJetpack DataStore是Google推荐的SharedPreferences替代品提供两种实现Preferences DataStore类似SharedPreferences的键值存储基于Kotlin协程和Flow提供类型安全APIProto DataStore使用Protocol Buffers存储结构化数据更适合复杂数据场景基本使用示例// 创建DataStore val dataStore: DataStorePreferences context.createDataStore( name settings ) // 写入数据 suspend fun saveDarkMode(enabled: Boolean) { dataStore.edit { preferences - preferences[PreferencesKeys.booleanPreferencesKey(dark_mode)] enabled } } // 读取数据 val darkModeFlow: FlowBoolean dataStore.data .map { preferences - preferences[PreferencesKeys.booleanPreferencesKey(dark_mode)] ?: false }5.2 MMKV腾讯开源的MMKV是一个高性能的键值存储解决方案比SharedPreferences更高的性能支持多进程提供更好的崩溃保护使用示例// 初始化 MMKV.initialize(this); // 获取实例 MMKV kv MMKV.defaultMMKV(); // 存储数据 kv.encode(bool, true); kv.encode(int, 123); // 读取数据 boolean bValue kv.decodeBool(bool); int iValue kv.decodeInt(int);5.3 如何选择场景推荐方案简单的配置/偏好SharedPreferences现代应用使用KotlinDataStore高性能需求MMKV复杂数据结构Room/SQLite6. 实际项目中的经验分享在多年的Android开发中我总结了以下关于SharedPreferences的实战经验键名管理使用常量类统一管理所有键名避免硬编码字符串减少拼写错误public class PrefsKeys { public static final String USER_NAME user_name; public static final String LOGIN_COUNT login_count; // ... }版本迁移处理当数据结构需要变更时考虑版本迁移可以清除旧数据或转换到新格式public void migratePrefs() { SharedPreferences oldPrefs getSharedPreferences(old_prefs, MODE_PRIVATE); SharedPreferences newPrefs getSharedPreferences(new_prefs, MODE_PRIVATE); if (!newPrefs.contains(migrated)) { // 执行迁移 newPrefs.edit() .putString(username, oldPrefs.getString(name, )) .putBoolean(migrated, true) .apply(); } }测试注意事项在单元测试中使用InMemorySharedPreferences避免测试污染真实数据Test public void testPreferences() { SharedPreferences prefs new MockSharedPreferences(); // 测试逻辑... }安全存储对于敏感信息如token应该加密存储可以使用AndroidX Security Crypto库String masterKeyAlias MasterKeys.getOrCreate(MasterKeys.AES256_GCM_SPEC); SharedPreferences securePrefs EncryptedSharedPreferences.create( secret_shared_prefs, masterKeyAlias, context, EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV, EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM );清理策略定期清理不再使用的键避免prefs文件无限制增长public void cleanupOldKeys() { SetString currentKeys new HashSet(Arrays.asList(key1, key2)); SharedPreferences prefs getSharedPreferences(my_prefs, MODE_PRIVATE); SharedPreferences.Editor editor prefs.edit(); for (String key : prefs.getAll().keySet()) { if (!currentKeys.contains(key)) { editor.remove(key); } } editor.apply(); }SharedPreferences作为Android开发中最基础的数据持久化方案虽然简单但要用好也需要考虑很多实际因素。随着项目规模的增长合理地组织和管理SharedPreferences的使用可以避免很多潜在的问题。