uni.clearStorageSync()仅清uni.setStorage数据，非一键清缓存；需组合四步：清storage、clearImageCache、plus.cache.clear、plus.io日志清理。
直接调用 uni.clearStorageSync() 只能清掉 uni.setStorage 写入的数据，不是“一键清空应用缓存”的完整解法。App 端真实缓存分散在多个隔离层，漏掉任何一层都会让用户感觉“明明清了，数据还在”。
uni.clearStorageSync() 能清什么、不能清什么
它只负责 uni-app 自己管理的本地存储区：token、用户配置、页面状态等通过 uni.setStorage 或 uni.setStorageSync 存的数据。但以下全不归它管：
-
localStorage.setItem('ab_test_group', 'v2')—— H5 里手动写的，uni.clearStorageSync()完全看不到 - WebView 加载过的 JS/CSS/图片 —— 归
plus.cache管，得另调 -
uni.downloadFile下载的文件、uni.saveFile保存的图片 —— 得先uni.getSavedFileList()，再逐个uni.removeSavedFile() - 日志文件（如写在
plus.io.getCacheDir()下的app-20260903.log）——uniAPI 无权限访问，必须用plus.io原生接口 - 内存中的 Vue 实例 data、Pinia store、原生层 SharedPreferences / NSUserDefaults —— 这些根本不在存储范畴，清 storage 毫无影响
App 端必须组合清理的四步操作
真要覆盖用户感知到的“应用缓存”，这四步缺一不可，且顺序和平台判断不能错：
- 调
uni.clearStorageSync()清 storage 数据（同步，无回调，立刻生效） - 加条件编译
#ifdef APP-PLUS，再调uni.clearImageCache()—— 小程序/H5 调用静默失败，不报错也不起作用 - 同样在
#ifdef APP-PLUS内，用const cache = uni.requireNativePlugin('plus.cache')，然后cache.clear(() => { console.log('WebView 缓存已清') }) - 日志清理必须自己实现：
plus.io.readdir({ path: plus.io.getCacheDir() })列出文件 → 逐个plus.io.stat()判断是否为.log或含log_的文件 → 再plus.io.remove()；注意并发数控制在 3–5 个以内，iOS 上超限会触发EMFILE: too many open files
为什么日志清理最容易被忽略或做错
因为 uni-app 没有统一日志模块，所有日志落地路径、命名、写入方式都由开发者决定，而错误往往藏在细节里：
- 路径误判：以为日志都在
uni.env.USER_DATA_PATH，其实很多 Android 厂商 ROM 和 SDK 默认写进plus.io.getCacheDir()，uni.getFileSystemManager()根本读不到 - 文件匹配漏项：只删
*.log，却漏掉带时间戳的滚动日志（如app-20260903-14.log）或未关闭写入流就删，留下锁文件 - 权限缺失：manifest.json 的 “模块权限配置” 里没勾选 “文件系统(plus.io)”，所有
plus.io.*API 全部静默失效，连readdir都返回空数组 - 没加时间过滤：直接删全部日志，可能把正在写入的活跃日志删掉，导致后续日志写入失败或丢失关键现场信息
真正难的不是写几行清除代码，而是理清缓存来源层级、确认每种缓存的归属平台、并验证清理后是否真的归零——比如 WebView 缓存清完，得调 plus.cache.calculate() 看返回值是否接近 0；日志删完，得进手机文件管理器手动检查 Android/data/[package]/cache/ 目录是否空了。
