MAUI中保存用户设置最常用、最轻量的方式是Preferences,专为键值对型配置设计,支持string、bool、int等基础类型,同步操作无需await,不支持自定义对象直接存储,敏感信息建议配合SecureStorage使用。
MAUI 保存用户设置最常用、最轻量的方式就是用 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 是轻量级首选项存储,不是持久化数据库:
基本上就这些。用对场景,Preferences 就是 MAUI 用户设置管理中最省心的方案。