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% 的本地文件需求都能稳稳落地。
