MAUI怎么读写本地文件 MAUI文件系统访问方法

MAUI本地文件读写应优先使用Microsoft.Maui.Storage.FileSystem提供的跨平台路径抽象与.NET异步I/O方法。首选AppDataDirectory存配置和用户数据，CacheDirectory存可清理缓存，TemporaryDirectory仅作临时中转；写入须用WriteAllTextAsync等异步方法并拼接FileSystem路径；读取本地文件用ReadAllTextAsync，读取嵌入资源则用OpenAppPackageFileAsync；访问公共目录需按平台声明权限或调用FilePicker。

MAUI 读写本地文件，核心是用好 Microsoft.Maui.Storage.FileSystem 提供的路径抽象 + .NET 标准异步 I/O 方法。不需为 Android、iOS 或 Windows 单独写路径或申请权限（私有目录下），关键在于选对目录、用对方法、避开常见坑。

用对目录：三种常用存储位置怎么选

MAUI 抽象出几个预定义目录，各司其职：

• AppDataDirectory：应用私有、持久化存储首选。适合配置文件、用户数据、数据库文件等。卸载应用时自动清除，无需额外权限。
• CacheDirectory：缓存类数据（如网络响应、缩略图）。系统可能在空间不足时自动清理，不适合存关键信息。
• TemporaryDirectory：纯临时用途（如解压中转、上传前缓存）。重启或系统清理后可能丢失，不保证保留。

写文件：两步搞定，推荐异步操作

以保存配置为例，写入 AppDataDirectory：

• 拼接完整路径：Path.Combine(FileSystem.AppDataDirectory, "config.json")
• 调用标准异步方法：await File.WriteAllTextAsync(filePath, content) 或 await File.WriteAllBytesAsync(filePath, data)

注意：不要用 File.WriteAllText 同步版本，会阻塞 UI 线程；路径必须由 FileSystem 提供，不能硬编码（如 "./data/config.txt"）。

读文件：文本、二进制、资源包文件分别处理

根据文件来源选择读法：

• 读取自己写入的本地文件：await File.ReadAllTextAsync(filePath)（文本）或 await File.ReadAllBytesAsync(filePath)（二进制）
• 读取打包进应用的只读资源（如默认配置、模板）：await FileSystem.OpenAppPackageFileAsync("defaults.json")，返回 Stream，再用 StreamReader 或 MemoryStream 处理

不支持直接用 File.OpenRead 读资源包文件，也不建议用 Environment.GetFolderPath 拼路径替代 FileSystem —— 后者才真正跨平台兼容。

绕过权限崩溃：哪些情况要特别注意

绝大多数场景下，用 AppDataDirectory 或 CacheDirectory 完全无需声明权限，也不会崩溃。但以下情况需额外处理：

• 想访问公共目录（如 Downloads、Pictures）：Android 需在 AndroidManifest.xml 声明 READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE（Android 10+ 推荐用 Scoped Storage）；iOS 默认禁止，只能通过 FilePicker.PickAsync() 让用户手动选文件
• 读写外部 SD 卡（Android）：需运行时请求权限，且 MAUI 不直接封装该能力，需调用平台特定代码
• 调试时路径为空？先确认 FileSystem.AppDataDirectory 是否已初始化（通常在 OnStart 或页面加载后可用，非构造函数中）

基本上就这些。用对目录 + 异步 I/O + 资源包专用 API，95% 的本地文件需求都能稳稳落地。