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 用户设置管理中最省心的方案。
