跨平台开发 / 系统课时
用 SharedPreferences 保存配置
用 SharedPreferences 保存配置
本篇介绍 Flutter 中保存轻量配置的常用方案。你将使用 SharedPreferences 保存主题、语言、开关状态等键值数据,并理解它适合解决什么问题,以及什么时候应该选择数据库或其他存储方案。
学习目标
- 理解 SharedPreferences 的数据模型和适用场景。
- 掌握保存和读取简单配置的方法。
- 判断轻量配置存储与其他持久化方案的边界。
认识 SharedPreferences 的使用场景
SharedPreferences 适合保存少量、结构简单的数据,例如用户是否开启通知、当前主题模式、选择的语言等。这类数据通常是键和值的关系,不需要复杂查询。
它不适合保存大量列表、关联数据或频繁变化的数据,这些场景更适合使用数据库。
保存和读取配置
Flutter 项目中通常通过 shared_preferences 插件访问本地键值存储。下面示例保存一个主题配置,并在应用启动时读取。
dart
import 'package:shared_preferences/shared_preferences.dart';
Future<void> saveThemeSetting(bool isDark) async {
final prefs = await SharedPreferences.getInstance();
// 使用稳定 key 保存用户偏好,避免版本升级后无法读取。
await prefs.setBool('dark_mode', isDark);
}
Future<bool> loadThemeSetting() async {
final prefs = await SharedPreferences.getInstance();
return prefs.getBool('dark_mode') ?? false;
}
void main() async {
await saveThemeSetting(true);
print(await loadThemeSetting());
}预期输出
text
true如果 key 不存在,读取方法会返回代码中设置的默认值。
管理配置变更
配置项增加后,应保持 key 命名稳定,并集中管理默认值。例如主题、语言、通知开关可以分别使用明确的 key,避免散落在业务代码中。
删除配置时可以调用对应删除方法,适用于用户退出登录或重置设置等场景。
dart
final prefs = await SharedPreferences.getInstance();
await prefs.remove('dark_mode');预期结果
text
key=dark_mode 已从本地存储移除使用边界和注意事项
SharedPreferences 底层适合存储简单偏好,但不保证适合作为敏感数据存储方案。密码、令牌等重要信息应使用安全存储机制。
当配置数量增加、数据关系变复杂,或者需要条件查询时,应迁移到数据库或专门的数据存储方案。正确划分存储职责,可以避免后续维护成本快速增加。
按自己的节奏,确认真正理解。