手册版本
v2026.04.17.1
发布日期 2026-04-17
下载 PDF
权限与文件访问¶
页面目标¶
帮助你区分“应用逻辑问题”和“系统文件访问限制”。
当前最常见的权限场景¶
- 文件选择器里看不到目标资料
- 选中文件后系统拒绝继续访问
- 导出到目标位置失败
- iOS 保存到相册失败
- 拖放文件时系统不允许读取内容
建议排查顺序¶
- 先看是否出现系统权限弹窗。
- 确认目标资料是否位于当前应用可访问的位置。
- 如果是 iOS，相册导出只对
PNG生效，先确认格式是否正确。 - 如果是 macOS，检查保存对话框选择的位置是否可写。
- 重新执行同一路径，确认问题是否稳定复现。
需要知道的几个实现细节¶
- 用户主动取消文件选择时，系统不会把它当成错误弹窗处理。
- 拖放导入依赖系统提供的
fileURL数据；如果系统不给访问权限，应用拿不到有效文件路径。 - iOS 的
Photos导出是单独路径，不等同于普通Files导出。
建议记录的信息¶
- 平台与系统版本
- 目标路径的大致位置
- 是否弹过系统权限请求
- 失败发生在导入、导出还是拖放
- 错误提示原文
常见问题¶
文件明明存在，为什么选择器里没有？¶
多数情况下是系统访问范围限制，而不是应用不知道这个文件存在。先把文件移动到更直接可访问的位置再试。
导出失败一定是导出功能坏了吗？¶
不一定。目标位置不可写、权限不足或格式与目标不匹配，都可能导致失败。
为什么保存到相册只支持 PNG？¶
因为当前实现里，相册出口只接了 PNG 写入流程，其他格式不会走这条路径。