「文稿/账单-8月.csv:系统没允许读取这个文件夹」+「重新选择」。用户在对话框里选一次就好了。
桌面软件 · 系统能力
本地文件读写Local File Access
让用户通过打开对话框或拖拽亲手交出文件,系统才稳定放行;读不到要在文件上说清原因并给「重新选择」,写文件要先问再覆盖。
先导入:三种拿到文件的方式,只有一种会被系统拦
账单整理应用要读用户的 CSV。把桌面上的文件拖进窗口、用「打开文件…」、点「最近打开」,最后导出汇总——每次结果都写在文件行上。
- 账单-10月.csvCSV
- 收据照片.heic图片
- 报销文件夹
- 账单汇总.xlsx上周 · 旧版
把 CSV 账单拖到这里
- 还没有导入:拖一个文件进来,或点「打开文件…」
把「账单-10月.csv」拖进窗口(或点它旁边的按钮),从这里开始。
知识点:用户亲手给的文件才稳
文件行上的成功和失败已经演过,这里只做命名。
- 打开对话框和拖拽是用户主动把文件交给应用,系统据此放行;按记住的旧路径直接读,可能被拦(EPERM / EACCES)。
- 失败要落在具体文件上:说清是格式不对、选了文件夹,还是没权限,并给「重新选择」。
- 写文件同样走对话框:让用户定位置;同名时先问替换还是另存,不能静默覆盖。
- 不要扫描用户没给过的目录;需要整个文件夹时,就让用户选文件夹。
什么时候用、怎么用
只要应用要读写用户电脑上的东西,就要把这几条写进需求。
- 信号:AI 报
EPERM、EACCES、operation not permitted,或用户说「拖进去没反应」。 - 不适用:只是网页里上传一个文件给服务器——那是「上传」,不需要桌面应用。
- 指令里写明两个入口:打开对话框和拖拽,以及支持哪些格式。
- 要求每种失败(格式、文件夹、无权限)在文件行上有一句人话和「重新选择」。
- 验收:拖错格式、拖文件夹、导出到已有同名文件各试一次。
正反例:同一个账单导入
功能一样,差别只在失败时用户看到什么。
错误只打在控制台,用户以为软件坏了;导出时悄悄覆盖了上周的汇总,数据找不回来。
快速自测
应用启动时自动读「上次打开的文件」,在新电脑上报 EPERM: operation not permitted。最合适的处理是?
继续查证
术语的技术定义和行为以这些一手或权威资料为准。
下一步学
和本知识点经常一起出现的概念。