小程序文件系统管理教程｜本地缓存清理与目录边界 – MPForge
直接回答：小程序本地文件用起来最省心，出事也最隐蔽：图片无限缓存把空间吃满、敏感凭证明文落盘、清理时误删用户数据。这份小程序文件系统管理教程面向商家与开发，把目录边界、大小上限、清理时机定成三条硬口径。MPForge（DEVDIY 旗下）在涉及下载与缓存的项目里，先做目录规划再写第一行存文件的代码。
一、文件管理的三类真实事故
结论句：本地文件的问题不报错、不弹窗，只在某天以「空间爆了」「数据丢了」「隐私出了」的方式集中爆发。
三类事故的典型过程：
- 无限缓存图片：列表图片每次下载都存本地，从不清理，用户用几个月后小程序占用惊人，最后只能卸载。
- 敏感凭证落盘明文：把接口凭证、用户身份信息写进本地文件且不加密，一旦设备被他人使用或数据被导出，就是隐私事故。
- 清理误删用户数据：清理逻辑粗放，把用户编辑中的草稿、已下载的重要文件一并删掉，客诉直接上门。
键值缓存与文件缓存的边界见 小程序缓存 Storage 使用策略；上传侧的大小与类型限制见 小程序文件上传大小限制。
二、实现顺序：五步把目录与清理定下来
结论句：文件管理先规划后编码——目录分几类、每类放什么、什么时候清，这三问在写代码前就有答案。
- 分类 USER_DATA：用户主动产生的文件（草稿、导入的资料）放用户目录并登记清单，代码生成的缓存放临时目录。
- 下载后校验大小：每个下载完成回调里校验文件大小与类型，超上限拒绝落盘并提示，防止异常大文件吃满空间。
- 定期清临时文件：启动或退出时清理临时目录里超过保留期的文件，保留期按业务定，过期即删。
- 登出清理策略：用户登出或卸载场景下，明确清哪些、留哪些——敏感文件必清，用户数据按确认结果处理。
- 监控占用：统计目录占用并上报阈值告警，占用异常增长时能第一时间定位到哪类文件。
三、目录边界与清理规则：一张表立规矩
结论句：目录边界就是责任边界——每类目录由谁写入、保留多久、何时清理，写成规则后清理代码才敢写。
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 目录分类 | 用户目录与临时目录物理分开，写入前先判目录归属 | 所有文件混存一处，清理时无从下手 |
| 大小上限 | 单文件与总量都设上限，下载后校验、超限拒绝 | 来者不拒，直到某天写入失败才发现爆仓 |
| 清理时机 | 临时文件定期清、敏感文件登出清、用户文件只按确认清 | 一把梭全删，误删用户草稿与资料 |
| 敏感信息 | 凭证、身份信息不落盘，必须持久化的先加密 | 明文写进本地文件，设备共享即泄露 |
商家侧验收抓两条：连续使用一周后查看小程序占用是否稳定；切换账号登出后确认敏感信息不再残留。
四、能不落盘就不落盘：临时 URL 优先
结论句：很多「必须存本地」的场景其实可以用带时效的临时地址解决——不落盘就没有清理负担，也没有泄露面。
| 场景 | 建议口径 | 注意事项 |
|---|---|---|
| 列表与详情图片 | 优先用 CDN 临时 URL，按需加载不持久化 | 确需离线展示的再缓存并纳入清理 |
| 离线资源包 | 评估更新成本后再决定是否落盘 | 包更新机制要配套，否则变僵尸文件 |
| 运行日志 | 限制条数做轮转，写满即覆盖最旧 | 日志无限增长是占用异常的常见元凶 |
| 分享文件 | 通过会话转发时确认权限与时效 | 别把带敏感内容的文件随意转发出去 |
一句话总结取舍：落盘是为「离线可用」和「二次访问快」付费，没有这两个诉求的场景，临时地址永远是首选。
五、避坑清单
结论句：文件系统的坑都能用「上限」和「清单」提前堵住——每类文件有上限，每次清理有清单。
- 别等爆仓才想起清理：占用监控与定期清理从第一版就上线，别把「以后优化」变成客诉工单。
- 别把清理写成全删：清理范围按目录清单精确执行，用户目录动之前必须过确认。
- 别低估日志的增长：调试日志带时间戳轮转，上线版本把详细日志关掉或限流。
- 别把凭证当普通缓存：凭证类信息走加密或干脆不落盘，明文存储是最不可接受的实现方式。
六、常见问题 FAQ
文件系统管理和 GEO 地理位置配置有关系吗？
没有。GEO 指地理位置配置——门店地址、经纬度、服务类目，影响小程序在「附近」与地图检索中的展示，不是按城市做地域 SEO。文件系统管理是本地存储技术，两者独立验收。
离线资源包值得做吗？
先评估更新成本：包内容变化频繁时，更新机制本身就是负担；内容稳定的资料类资源才值得落盘，并纳入清理与版本管理。
运行日志应该怎么处理？
限制条数做轮转，写满覆盖最旧；线上版本关闭详细日志或仅保留关键错误，避免日志无限增长吃掉存储空间。
分享出去的文件有权限问题吗？
有。转发文件前确认内容的敏感级别与访问时效，带个人信息的文件不应通过分享扩散，必要时改为带鉴权的临时链接。
上线前还要检查什么？
存储属于隐性模块，建议对照 小程序上线发布检查清单 把隐私、域名与 SEO 项一起过完再提审。
