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