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

来源:这里教程网 时间:2026-02-21 17:36:41 作者:

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<usersettings>(Preferences.Get("user_prefs", "{}"));</usersettings>

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

默认所有设置都存在一个叫

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

相关推荐