跨平台开发 / 系统课时

用 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 底层适合存储简单偏好,但不保证适合作为敏感数据存储方案。密码、令牌等重要信息应使用安全存储机制。

当配置数量增加、数据关系变复杂,或者需要条件查询时,应迁移到数据库或专门的数据存储方案。正确划分存储职责,可以避免后续维护成本快速增加。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 SharedPreferences 保存配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通