Flutter 轻量存储方案介绍、区别、对比和使用场景

在 Flutter 项目中本地存储通常可以分为几类第一类是轻量 Key-Value 存储例如 shared_preferences、get_storage、mmkv适合保存开关、配置、登录状态等简单数据。第二类是安全存储例如 flutter_secure_storage适合保存 token、refresh token、密钥等敏感信息。第三类是轻量 NoSQL / 本地数据库例如 hive_ce、sembast、objectbox、drift适合保存列表、缓存、结构化数据、离线数据等。本文主要介绍 Flutter 项目中常见、好用、相对轻量的本地存储方案并给出选择建议。一、先给结论怎么选场景推荐方案保存主题、语言、开关、引导页状态shared_preferences保存简单 JSON、页面缓存、非敏感配置get_storage / shared_preferences保存 token、refresh token、用户凭证flutter_secure_storage保存 Flutter Web / 多端简单本地数据shared_preferences / hive_ce / sembast保存对象列表、离线缓存、草稿箱hive_ce / sembast保存复杂查询、关系型数据drift追求高性能对象数据库、数据量较大objectbox移动端高性能 Key-Valuemmkv一句话总结简单配置用 shared_preferences敏感数据用 flutter_secure_storage对象缓存用 hive_ce复杂关系数据用 drift高性能本地数据库用 objectbox。二、shared_preferences1. 简介shared_preferences 是 Flutter 官方维护的轻量 Key-Value 存储插件主要用于保存简单配置数据。它底层会包装 Android 的 SharedPreferences、iOS 的 NSUserDefaults 等平台能力。官方文档中也提到从 2.3.0 开始提供了新的 SharedPreferencesAsync 和 SharedPreferencesWithCache API旧的 SharedPreferences API 未来会被废弃新项目更推荐使用新版 API。2. 适合存什么适合是否第一次打开 App主题模式语言设置用户是否同意隐私协议某些功能开关上次选择的 tab简单的用户偏好不适合token 等敏感信息大量列表数据复杂对象关系高频读写数据强一致性业务数据3. 安装dependencies:shared_preferences:^latest4. 推荐用法SharedPreferencesAsyncimportpackage:shared_preferences/shared_preferences.dart;classAppPrefs{finalSharedPreferencesAsync_prefsSharedPreferencesAsync();FuturevoidsetDarkMode(bool value)async{await_prefs.setBool(dark_mode,value);}FutureboolgetDarkMode()async{returnawait_prefs.getBool(dark_mode)??false;}FuturevoidsetLanguage(Stringvalue)async{await_prefs.setString(language,value);}FutureStringgetLanguage()async{returnawait_prefs.getString(language)??zh_CN;}}5. 优点官方维护接入简单多平台支持好适合轻量配置学习成本低6. 缺点不适合大量数据不适合敏感信息不适合复杂查询旧 API 未来会逐步被替代三、flutter_secure_storage1. 简介flutter_secure_storage 是 Flutter 中常用的安全存储插件用于保存敏感数据。它会使用平台级安全能力例如 iOS Keychain、Android 加密存储等。官方介绍中也说明它用于以 Key-Value 形式安全存储敏感数据并支持 Android、iOS、macOS、Windows、Linux 等平台。2. 适合存什么适合access tokenrefresh token登录凭证用户密钥设备绑定信息加密盐值敏感配置不适合大量列表数据普通业务缓存图片、文件、大 JSON高频大量读写3. 安装dependencies:flutter_secure_storage:^latest4. 基础用法importpackage:flutter_secure_storage/flutter_secure_storage.dart;classTokenStorage{staticconst_storageFlutterSecureStorage();FuturevoidsaveToken(Stringtoken)async{await_storage.write(key:access_token,value:token);}FutureString?getToken()async{returnawait_storage.read(key:access_token);}FuturevoidclearToken()async{await_storage.delete(key:access_token);}}5. 优点安全性高适合保存 tokenAPI 简单支持多平台6. 缺点性能不如普通 Key-Value 存储不适合大量数据不同平台行为可能略有差异需要关注备份、卸载、系统迁移等边界情况7. 实战建议实际项目中不要把所有用户数据都放进 flutter_secure_storage。推荐方式token / refresh token - flutter_secure_storage主题 / 语言 / 普通配置 - shared_preferences用户资料缓存 / 页面缓存 - hive_ce / sembast四、get_storage1. 简介get_storage 是一个非常轻量、同步读写的 Key-Value 存储库。它会先把数据放在内存中每次操作后再备份到磁盘。官方文档中描述它是一个快速、超轻量、同步的内存 Key-Value 存储并支持 String、int、double、Map、List 等类型。它常见于 GetX 项目但不代表只能在 GetX 中使用。2. 适合存什么适合简单配置页面状态缓存轻量 JSON临时偏好设置非敏感用户信息不适合token大量数据复杂查询高可靠业务数据3. 安装dependencies:get_storage:^latest4. 使用示例importpackage:get_storage/get_storage.dart;Futurevoidmain()async{awaitGetStorage.init();finalboxGetStorage();box.write(theme,dark);finalthemebox.readString(theme);box.remove(theme);}封装一下classLocalCache{finalGetStorage_boxGetStorage();voidsaveUserName(Stringname){_box.write(user_name,name);}StringgetUserName(){return_box.readString(user_name)??;}voidclear(){_box.erase();}}5. 优点非常简单同步 API使用方便读写速度快适合小型项目适合 GetX 项目6. 缺点不是官方方案不适合敏感数据不适合大规模数据复杂数据维护能力较弱五、MMKV1. 简介mmkv 是腾讯微信团队开源的高性能 Key-Value 存储方案。Flutter 的 mmkv 包介绍中提到它是一个高效、小巧、易用的移动端 Key-Value 存储框架目前主要支持 Android 和 iOS。2. 适合存什么适合高频读取的简单配置移动端缓存启动阶段需要快速读取的数据性能敏感的 Key-Value 数据不适合Flutter Web 项目桌面端优先项目复杂对象关系强 SQL 查询需求3. 特点性能优秀移动端表现好适合替代部分 SharedPreferences 场景底层能力成熟4. 注意点mmkv 更偏移动端虽然包生态中有一些平台实现但如果你的项目非常重视 Flutter Web、Windows、macOS、Linux 的统一体验需要谨慎选择。六、hive_ce1. 简介过去很多 Flutter 项目会使用 Hive。现在更推荐关注 hive_ce它是 Hive 的社区延续版本。hive_ce 官方介绍中提到它是一个轻量、快速的 Key-Value 数据库使用纯 Dart 编写变更记录也说明 2.3.0 是 Hive Community Edition 的首次发布并支持 Flutter Web WASM 编译。2. 适合存什么适合对象缓存离线列表搜索历史草稿箱用户资料缓存简单业务数据接口响应缓存不适合复杂 SQL 关系查询强事务关系模型超复杂数据分析3. 安装dependencies:hive_ce:^latesthive_ce_flutter:^latestdev_dependencies:build_runner:^latesthive_ce_generator:^latest4. 基础用法importpackage:hive_ce_flutter/hive_flutter.dart;Futurevoidmain()async{awaitHive.initFlutter();finalboxawaitHive.openBox(app_cache);awaitbox.put(name,Zender);finalnamebox.get(name);awaitbox.delete(name);}5. 保存对象示例classUserCache{finalBoxbox;UserCache(this.box);FuturevoidsaveUser(MapString,dynamicuser)async{awaitbox.put(user,user);}MapString,dynamic?getUser(){finalvaluebox.get(user);if(valueisMap){returnMapString,dynamic.from(value);}returnnull;}}6. 优点轻量速度快纯 Dart适合缓存对象API 简单比 shared_preferences 更适合存结构化数据7. 缺点复杂查询能力有限对象模型变更需要注意兼容不适合强关系型数据七、sembast1. 简介sembast 是一个纯 Dart 的 NoSQL 文档型本地数据库。官方介绍中提到它适用于 Dart VM 和 Flutter不需要插件支持 Android、iOS、macOS、Linux、Windows 等平台数据库以单文件形式存在数据会在打开时加载到内存变更会追加写入文件。2. 适合存什么适合本地文档数据列表缓存离线数据简单查询多平台 Flutter 应用不适合超大规模数据复杂 SQL join极致性能场景强类型对象数据库场景3. 安装dependencies:sembast:^latestpath_provider:^latestpath:^latest4. 使用示例importpackage:path/path.dart;importpackage:path_provider/path_provider.dart;importpackage:sembast/sembast_io.dart;classSembastDb{lateDatabasedb;finalstoreintMapStoreFactory.store(users);Futurevoidinit()async{finaldirawaitgetApplicationDocumentsDirectory();finaldbPathjoin(dir.path,app.db);dbawaitdatabaseFactoryIo.openDatabase(dbPath);}FutureintinsertUser(MapString,dynamicuser)async{returnawaitstore.add(db,user);}FutureListRecordSnapshotint,MapString,dynamicgetUsers()async{returnawaitstore.find(db);}}5. 优点纯 Dart跨平台好文档模型灵活适合保存 JSON 类数据支持简单查询6. 缺点数据量很大时不一定合适类型约束没有 Drift/ObjectBox 强复杂业务模型维护成本会上升八、drift1. 简介drift 是 Flutter/Dart 中非常成熟的响应式 SQLite 封装库适合关系型数据、本地复杂查询、离线业务数据。官方介绍中提到Drift 是一个用于 Dart 和 Flutter 应用存储关系型数据的响应式库drift_flutter 则提供 Flutter 项目中更方便的数据库初始化能力。2. 适合存什么适合本地订单聊天记录离线任务复杂列表筛选多表关系分页查询本地搜索需要 SQL 能力的数据不适合只保存一个主题色只保存一个 token极简单配置不想引入代码生成的小项目3. 安装dependencies:drift:^latestdrift_flutter:^latestdev_dependencies:drift_dev:^latestbuild_runner:^latest4. 表定义示例importpackage:drift/drift.dart;classTodosextendsTable{IntColumngetidinteger().autoIncrement()();TextColumngettitletext()();BoolColumngetdoneboolean().withDefault(constConstant(false))();DateTimeColumngetcreatedAtdateTime()();}5. 适合中大型项目如果你的 Flutter App 有比较明显的业务数据例如本地草稿消息列表收藏列表下载记录订单记录离线表单多条件筛选这类场景用 drift 会比 shared_preferences、get_storage 更可靠。6. 优点基于 SQLite关系型数据能力强支持响应式查询适合复杂业务生态成熟7. 缺点接入成本高于 Key-Value需要表结构设计通常需要代码生成小项目可能显得偏重九、objectbox1. 简介objectbox 是一个高性能对象数据库。官方介绍中提到ObjectBox Flutter 数据库适合跨平台和 AI 驱动应用并支持向量搜索、相似度搜索、设备端 AI 等能力。它适合需要较高性能、本地对象持久化、较多数据读写的 App。2. 适合存什么适合大量对象数据离线业务数据高性能本地缓存本地搜索AI / RAG / 向量检索相关数据IoT / 边缘设备数据不适合只保存少量配置只保存 token非常简单的小项目对包体积极其敏感的场景3. 优点性能强对象模型友好适合大量本地数据支持高级能力例如向量搜索4. 缺点接入复杂度高于 Hive/Sembast需要生成代码概念比 Key-Value 存储多小项目可能没必要十、localstorage1. 简介localstorage 是一个简单的本地存储库风格类似前端的 localStorage。官方说明中特别提醒它不适合存储大量数据或敏感数据。2. 适合场景适合Demo 项目小工具简单页面状态少量本地缓存不适合生产级复杂业务敏感数据大量数据复杂查询3. 使用建议如果是正式项目我更推荐优先选择shared_preferencesflutter_secure_storagehive_cesembastdriftlocalstorage 更适合非常简单的场景。十一、核心对比表方案类型是否适合敏感数据是否适合复杂查询数据量推荐指数shared_preferencesKey-Value否否小★★★★★flutter_secure_storage安全 Key-Value是否小★★★★★get_storageKey-Value否否小★★★★mmkv高性能 Key-Value一般否小到中★★★★hive_ceNoSQL / KV 数据库可自行加密一般中★★★★★sembastNoSQL 文档数据库可自行加密一般中★★★★driftSQLite ORM否是中到大★★★★★objectbox对象数据库否强中到大★★★★localstorage简单本地存储否否小★★★十二、按业务场景选择1. 保存 App 配置例如主题模式语言是否首次打开是否开启通知是否显示某个弹窗推荐shared_preferences理由官方维护、简单稳定、配置型数据非常适合2. 保存登录 token推荐flutter_secure_storage不要用shared_preferences、get_storage、hive、普通文件原因token 属于敏感数据应该使用系统安全存储能力。推荐封装classAuthStorage{staticconst_storageFlutterSecureStorage();staticconst_accessTokenKeyaccess_token;staticconst_refreshTokenKeyrefresh_token;FuturevoidsaveTokens({requiredStringaccessToken,requiredStringrefreshToken,})async{await_storage.write(key:_accessTokenKey,value:accessToken);await_storage.write(key:_refreshTokenKey,value:refreshToken);}FutureString?getAccessToken(){return_storage.read(key:_accessTokenKey);}FutureString?getRefreshToken(){return_storage.read(key:_refreshTokenKey);}Futurevoidclear()async{await_storage.delete(key:_accessTokenKey);await_storage.delete(key:_refreshTokenKey);}}3. 保存用户信息缓存例如昵称头像会员状态用户偏好上次接口返回的用户资料推荐hive_ce、sembast如果只是极少字段也可以用shared_preferences4. 保存列表缓存例如首页 feed 流搜索历史收藏列表最近使用草稿箱推荐hive_ce、sembast如果需要多条件筛选和分页查询drift5. 保存复杂离线业务数据例如订单聊天记录离线任务下载记录本地表单多表关联数据推荐drift、objectbox选择建议偏 SQL、关系型、多表查询drift偏对象模型、高性能、对象持久化objectbox6. 保存 AI / 向量搜索相关本地数据推荐objectbox原因ObjectBox 官方已经强调其在设备端 AI、RAG、相似度搜索、向量搜索等方向的能力。十三、Flutter 项目中的推荐组合小型项目组合shared_preferences flutter_secure_storage适合工具类 App个人项目简单业务无复杂离线数据示例主题、语言 - shared_preferencestoken - flutter_secure_storage中型项目组合shared_preferences flutter_secure_storage hive_ce适合有登录有接口缓存有用户资料有列表缓存有草稿数据示例主题、语言 - shared_preferencestoken - flutter_secure_storage用户资料、首页缓存、草稿 - hive_ce中大型项目组合shared_preferences flutter_secure_storage drift适合复杂业务 App有离线能力有本地多表数据有分页查询有搜索和筛选示例基础配置 - shared_preferences登录凭证 - flutter_secure_storage订单、聊天、收藏、任务 - drift高性能本地对象存储项目组合shared_preferences flutter_secure_storage objectbox适合数据量较大高频读写对象模型复杂端侧 AI / 向量检索离线优先应用十四、不要滥用本地存储很多项目容易犯一个错误什么都往本地存。本地存储应该遵循几个原则能不存就不存敏感数据加密存缓存数据要有过期策略用户退出登录要清理用户级缓存不同用户的数据要隔离重要业务数据要考虑同步和冲突例如接口缓存建议加上时间戳classCacheData{finalMapString,dynamicdata;finalint cacheTime;CacheData({requiredthis.data,requiredthis.cacheTime,});boolgetisExpired{finalnowDateTime.now().millisecondsSinceEpoch;returnnow-cacheTime10*60*1000;}}十五、推荐封装思路不要在业务代码里到处直接调用存储库。不推荐finalprefsSharedPreferencesAsync();awaitprefs.setString(token,token);推荐先定义统一 Key 管理classStorageKeys{staticconstthemeModetheme_mode;staticconstlanguagelanguage;staticconstaccessTokenaccess_token;staticconstuserInfouser_info;}然后封装成服务classAppStorage{finalSharedPreferencesAsync_prefsSharedPreferencesAsync();FuturevoidsetThemeMode(Stringvalue){return_prefs.setString(StorageKeys.themeMode,value);}FutureStringgetThemeMode()async{returnawait_prefs.getString(StorageKeys.themeMode)??system;}FuturevoidsetLanguage(Stringvalue){return_prefs.setString(StorageKeys.language,value);}FutureStringgetLanguage()async{returnawait_prefs.getString(StorageKeys.language)??zh_CN;}}如果项目使用 Riverpod可以这样注入finalappStorageProviderProviderAppStorage((ref){returnAppStorage();});使用finalstorageref.read(appStorageProvider);awaitstorage.setThemeMode(dark);这样做的好处是统一管理 key方便替换存储方案方便单元测试业务代码更干净避免 key 到处散落十六、最终推荐如果是普通 Flutter 项目我建议这样选简单配置shared_preferences敏感数据flutter_secure_storage对象缓存hive_ce文档型缓存sembast复杂关系数据drift高性能对象数据库objectbox最通用的组合是shared_preferences flutter_secure_storage hive_ce如果项目有复杂离线业务升级为shared_preferences flutter_secure_storage drift如果项目对本地性能要求很高或者需要端侧 AI / 向量能力可以考虑shared_preferences flutter_secure_storage objectbox总体来说不存在一个存储库适合所有场景。Flutter 本地存储的最佳实践不是“选最强的”而是“按数据类型分层存储”。简单配置、敏感信息、业务缓存、复杂离线数据应该分别选择不同的存储方案。