layui 无卸载概念,所谓“清理缓存”实为手动清除内存或 dom 中的运行时状态;table.clearcache 仅清指定表格缓存,upload 需删 files 对象并 reload,form 需手动重置 checkbox 状态,跨模块状态须自行管理。

Layui 没有“卸载”概念,所谓“清理缓存”实际是清除运行时生成的内部状态和 DOM 副本。它不是 Node.js 包或系统级软件,不写入全局磁盘缓存,所有“缓存”都存在于内存或 DOM 中。强行找“卸载程序”或删 node_modules 里的 layui 文件夹,对已上线页面毫无作用。
table.clearCache 只清表格缓存,不碰其他模块
调用 table.clearCache('yourTableId') 仅清除 layui.table.cache['yourTableId'] 对象里存的行数据、checked、allChecked 等键值,不影响 form、upload、layer 等其他模块的状态。它不会删除你用 layui.cache 手动存的数据,也不会清 localStorage 或 sessionStorage。
- 必须传字符串 ID,不能传 DOM 元素或实例对象
- 若多个表格共用同一 ID(比如重复 render 未销毁),会误清其他表缓存
- 它不触发任何事件,属于底层静默操作,适合在 tab 切换、弹窗关闭前调用
upload 实例的 files 属性才是真实文件队列
layui upload 的“缓存”全存在实例的 files 属性里,比如 uploadInst.files。这个对象是 key-value 结构(key 如 "1612418956647-0"),不是数组。直接赋值 uploadInst.files = {} 或 uploadInst.files = [] 都不行——前者会让后续 done 回调的 index 参数失效,后者可能被内部逻辑覆盖。
- 正确做法:遍历
uploadInst.files,对每个 key 执行delete uploadInst.files[key] - 删完必须调
uploadInst.reload(),否则 DOM 预览图还在 - 别碰
uploadInst.config.files,这是内部只读属性,改了会引发上传逻辑错乱
form.render 后的 checkbox 状态要手动归零
form.render('checkbox') 只同步 DOM 和 class,不重置 layui.form.cache 里的勾选记录。如果你用 form.on('checkbox') 监听了事件,缓存里仍存着旧的 name/value 映射。真正的“清空”需要两步:
- 执行
layui.form.cache = {}(慎用,会影响所有 form 实例) - 或更安全地:对每个 checkbox input,用原生 JS 设
elem.checked = false,再调form.render('checkbox') - 注意:不要用 jQuery 的
.prop('checked', false),Layui 的 checkbox 是封装过的,原生操作更可靠
真正难清理的是跨模块耦合状态——比如你用 selectedIds = new Set() 手动维护表格勾选项,又在 upload 的 done 里往里塞 ID,这些变量全靠你自己管理。Layui 不提供统一的“全局清空 API”,所有“缓存”本质是你代码里没及时释放的引用。











