在 .NET MAUI 中,官方已经默认内置了多个专门用于存储文件或数据的类和 API。你不需要安装任何第三方插件,直接引入 Microsoft.Maui.Storage 命名空间即可使用。
根据你的数据类型和存储需求,MAUI 提供了以下 3 种最常用的内置存储方式:
1. 存储简单的配置、状态或键值对:Preferences
如果你只需要存储用户的配置(如:自动登录 true/false、上次打开的文件路径、用户皮肤颜色等),应该使用 Preferences。它在底层会自动调用各平台的原生存储(如 Windows 的 LocalSettings、Android 的 SharedPreferences、iOS 的 NSUserDefaults)。
• 特点: 适合小数据、简单键值对;读写极快;应用卸载后数据自动清除。

using Microsoft.Maui.Storage;

// 1. 存储数据 (支持 string, int, bool, double 等基本类型)
Preferences.Default.Set("LastOpenFilePath", @"C:\test1.txt");
Preferences.Default.Set("IsAutoRefresh", true);

// 2. 读取数据 (第二个参数是“默认值”,即如果找不到该键,就返回这个默认值)
string lastPath = Preferences.Default.Get("LastOpenFilePath", "未选择文件");
bool isAuto = Preferences.Default.Get("IsAutoRefresh", false);

// 3. 删除数据
Preferences.Default.Remove("IsAutoRefresh"); // 删除单个
Preferences.Default.Clear();                 // 清空所有配置

2. 获取安全的系统沙盒路径:FileSystem
果你要存储真正的文件(如:下载生成 PDF、JSON 缓存文件等),绝对不能写死绝对路径,必须使用 FileSystem。它能帮你自动获取当前应用在不同操作系统下的安全沙盒目录。
• 核心沙盒路径:
• FileSystem.Current.AppDataDirectory:应用数据目录。适合存放永久保存、不想让用户直接在手机文件管理器里翻到的私有数据。
• FileSystem.Current.CacheDirectory:缓存目录。适合存放临时文件、随时可以被系统清理的数据。

using Microsoft.Maui.Storage;
using System.IO;

// 示例:将一段文本保存为本地的 JSON 缓存文件
async Task SaveDataToFileAsync()
{
    // 1. 获取当前应用合法的私有数据存储目录
    string targetFolder = FileSystem.Current.AppDataDirectory;
    
    // 2. 拼接完整的文件路径
    string filePath = Path.Combine(targetFolder, "config.json");
    
    // 3. 使用标准 C# 的 File 类直接读写
    string jsonContent = "{ \"version\": \"1.0\", \"theme\": \"Dark\" }";
    await File.WriteAllTextAsync(filePath, jsonContent);
}

// 示例:读取该本地文件
async Task<string> ReadDataFromFileAsync()
{
    string filePath = Path.Combine(FileSystem.Current.AppDataDirectory, "config.json");
    
    if (File.Exists(filePath))
    {
        return await File.ReadAllTextAsync(filePath);
    }
    return string.Empty;
}

3. 安全加密存储敏感数据:SecureStorage
如果你需要存储密码、Token、API 密钥等敏感隐私数据,绝对不能用 Preferences,必须使用 SecureStorage。它在底层会调用各平台的安全加密硬件或服务(如 Windows 的 DataProtectionProvider、Android 的 KeyStore、iOS 的 Keychain)。
• 特点: 异步操作,底层自动高强度加密。

using Microsoft.Maui.Storage;

// 1. 安全存储敏感数据(必须使用 await)
await SecureStorage.Default.SetAsync("UserPasswordToken", "secret_token_123456");

// 2. 读取加密数据
string token = await SecureStorage.Default.GetAsync("UserPasswordToken");

// 3. 删除数据
SecureStorage.Default.Remove("UserPasswordToken");

 

存储类名 适合存储什么? 底层逻辑 是否加密
Preferences 用户设置、布尔值、简单字符串、数字 原生配置(如 SharedPreferences) 否
FileSystem 录像文件、图片、日志、大段文本、DB文件 系统分配的应用独立沙盒文件夹 否(需手动)
SecureStorage 登录密码、支付 Token、核心 API 密钥 原生硬件级加密锁(如 Keychain) 是