filepicker.pickasync() 返回 null 的主因是平台配置缺失：android 需 manifest 权限、ios 需 info.plist 描述、windows 需 appxmanifest 能力声明；且必须在 ui 线程调用，真机测试需签名包，后台调用或初始化失败均导致 null。
FilePicker.PickAsync() 为什么只返回 null？
调用 FilePicker.PickAsync() 后返回 null，最常见的原因是没在平台项目里配权限或初始化——MAUI 的文件选择器不是纯托管逻辑，它依赖原生能力。
Android 需要在 AndroidManifest.xml 里加 READ_EXTERNAL_STORAGE（Android 12+ 还得加 MANAGE_EXTERNAL_STORAGE 或改用沙盒路径）；iOS 要在 Info.plist 加 NSPhotoLibraryUsageDescription 等描述字段；Windows 则需确保项目启用 Windows Desktop Extensions 并在 Package.appxmanifest 勾选“文件系统访问”能力。
- 调试时先检查
Application.Current.MainPage.DisplayAlert是否能弹出——如果连这个都失败，说明平台初始化根本没走通 - 真机测试必须用签名包，模拟器对某些权限（如 Android 存储）行为不一致
-
PickAsync()在后台线程调用会直接返回null，务必确保在 UI 线程触发
单文件 vs 多文件：PickOptions 参数怎么设才生效？
PickOptions 的 PickerTitle 和 FileTypes 对单/多选都起作用，但是否允许多选，只取决于你传的是 PickAsync() 还是 PickMultipleAsync() ——别指望靠 FileTypes 里的通配符触发多选。
FileTypes 必须用 FileType 构造，且不同平台识别方式不同：Android 支持 MIME 类型（如 "image/*"），iOS 只认 UTI（如 "public.image"），Windows 则依赖扩展名数组（如 new string[] { ".jpg", ".png" }）。混用会导致某平台完全不显示对应文件。
- 多文件选完后返回的是
IReadOnlyList<readonlyfile></readonlyfile>，不是ReadOnlyFile单个对象 -
PickMultipleAsync()在 iOS 上实际调用的是UIDocumentPickerViewController，不支持纯图片/视频过滤，只能按 UTI 分组（比如"public.data"） - Android 10+ 强制使用分区存储，
PickAsync()返回的ReadOnlyFile的FullPath很可能为空，必须用OpenReadAsync()流式读取
读取文件内容时 Stream.ReadAsync 报 ObjectDisposedException
拿到 ReadOnlyFile 后调 OpenReadAsync()，再用 Stream.ReadAsync() 读取，结果抛 ObjectDisposedException——根本原因是 MAUI 的 ReadOnlyFile 实现是“一次性的”，流关闭后不能重复打开。
更隐蔽的问题是：你在 using 块里读完流，但后续又试图访问 ReadOnlyFile.Name 或 ReadOnlyFile.ContentType，某些平台实现（特别是 Android）会在流关闭后清空这些属性，导致 NRE。
- 别缓存
Stream对象，每次需要读都重新调OpenReadAsync() - 想保留文件名或类型，务必在打开流之前就存到本地变量里
- 大文件别一次性
ReadAllBytesAsync()，容易 OOM；用分块读 + 进度回调更稳妥
Windows 上 PickAsync 不弹窗，或者只列出 OneDrive 文件
Windows 平台下 FilePicker.PickAsync() 默默失败、无报错、也不弹窗，大概率是没启用 WinRT 支持或 app.manifest 配置缺失。MAUI 的 Windows 文件选择器底层调的是 Windows.Storage.Pickers.FileOpenPicker，它默认只展示“库”（Libraries）和 OneDrive，不会显示 C:\ 全盘。
要访问任意路径，必须在 Package.appxmanifest 的 Capabilities 节点显式声明 rescap:Capability Name="broadFileSystemAccess"，且用户需在系统设置里手动开启“允许应用访问文件系统”开关。
- 开发阶段可在 Windows 设置 → 隐私 → 文件系统 → 找到你的应用并开启权限
- 发布到 Store 的应用，该能力需单独申请认证，普通提交会被拒
- 若只需访问文档/图片等标准库，不用 broadFileSystemAccess，但得用
FilePicker.PickOptions.PickerLocationId指定PickerLocationId.DocumentsLibrary等常量
