MAUI怎么保存用户设置 MAUI Preferences使用教程

MAUI中保存用户设置最常用、最轻量的方式是Preferences，专为键值对型配置设计，支持String、bool、int等基础类型，同步操作无需await，不支持自定义对象直接存储，敏感信息建议配合SecureStorage使用。

MAUI 保存用户设置最常用、最轻量的方式就是用 Preferences。它专为键值对型配置设计，比如主题开关、语言选择、是否开启通知这类小而固定的偏好数据，开箱即用，跨平台一致，不需要额外配置权限或数据库。

Preferences 基本写法：存和取

它用起来非常直白，核心就两个方法：Set 和 Get：

• 存一个字符串：Preferences.Set("theme", "dark");
• 存一个布尔值：Preferences.Set("notifications_enabled", true);
• 读取时带默认值（推荐）：var theme = Preferences.Get("theme", "light");
• 检查某项是否存在：bool hasToken = Preferences.ContainsKey("auth_token");

所有操作都是同步的，无需 await，也不用担心线程阻塞。

支持哪些类型？别乱塞对象

Preferences 原生支持：string、bool、int、double、Float、long、DateTime —— 这些可以直接存取。

⚠️ 注意：它不支持直接存自定义类或复杂嵌套对象。如果硬塞进去，可能在某些平台序列化失败，或者下次读不出来。真要存结构化数据，建议自己转成 jsON 字符串再存，例如：

• Preferences.Set("user_prefs", jsonSerializer.Serialize(mySettings));
• 读取时再反序列化：var settings = JsonSerializer.Deserialize(Preferences.Get("user_prefs", "{}"));

进阶用法：共享容器与解耦设计

默认所有设置都存在一个叫 default 的容器里。如果你需要隔离不同模块的配置（比如登录模块和主题模块互不干扰），可以指定 sharedName：

• Preferences.Set("token", "abc123", "auth_container");
• var token = Preferences.Get("token", "", "auth_container");

更推荐的做法是封装一层服务接口，避免到处硬写 Preferences：

• 定义接口：public Interface ISettingsService { bool IsDarkMode { get; set; } }
• 实现类里统一用 Preferences 读写，方便单元测试和后期替换存储方式

注意事项：不是万能的，别当数据库用

Preferences 是轻量级首选项存储，不是持久化数据库：

• 适合存几十个 KB 以内的配置项，单个值别超几 KB
• 不适合存列表、大量用户记录、图片路径集合等结构化/高频变动数据
• 没有查询能力，不能按条件筛选，只能靠 key 精确读写
• 数据自动持久化，重启后还在，但不提供备份或加密（敏感信息如 token 建议配合 SecureStorage）

基本上就这些。用对场景，Preferences 就是 MAUI 用户设置管理中最省心的方案。