MAUI 的
SecureStorage是专为安全保存小段敏感数据（如 token、密码、密钥）设计的跨平台 API，它不是用来存大文件或大量文本的。用对了很省心，用错了容易报错或数据丢失。
基础写入与读取
这是最常用的操作，适用于保存 OAuth 令牌、用户登录态等：
写入值：await SecureStorage.Default.SetAsync("api_token", "ey...");
读取值：string token = await SecureStorage.Default.GetAsync("api_token");如果没存过，返回
null，不是空字符串 删除单个键：
SecureStorage.Default.Remove("api_token");
清空全部（慎用）：SecureStorage.Default.RemoveAll();
异常处理必须加
SecureStorage 在某些场景下会直接抛异常，比如：设备不支持加密、系统重置过密钥、旧版数据迁移失败。不能只靠 try-catch，还要有兜底逻辑：
每次GetAsync后检查是否为
null，再决定走登录流程还是继续使用 遇到
InvalidOperationException或
CryptographicException时，建议先
Remove再重试写入 不要在启动页强行读取并阻塞 UI，异步加载 + 空值判断更稳妥
注意平台差异和迁移兼容
从 Xamarin.Forms 升级到 MAUI 的老项目要特别小心：
MAUI 默认用新存储名：{包名}.microsoft.maui.essentials.preferences，旧数据存在 {包名}.xamarinessentials 里
Android 和 iOS 上可启用 LegacySecureStorage自动读取旧数据（需手动初始化） Windows 平台用的是
DataProtectionProvider，依赖系统账户和打包方式，未打包应用数据存在
securestorage.dat文件中
什么不该存？
SecureStorage 不是万能保险箱：
❌ 别存 JSON 字符串、Base64 图片、长文本（性能差，有 8KB 单值限制） ❌ 别存文件路径或二进制流（用FileSystem.AppDataDirectory+ 普通文件操作） ✅ 适合存：
refresh_token、
user_id、
device_key这类短且关键的字符串
基本上就这些。用起来不复杂，但容易忽略异常和平台迁移细节。
