必须开服务端分页并设height触发虚拟滚动,否则即使仅500行也会卡顿;后端未按page/limit查库、未返回count字段、未正确映射参数、未设height、滥用templet函数及冗余组件均会导致渲染卡顿。

必须开服务端分页 + 设 height 触发虚拟滚动,否则哪怕只渲染 500 行也会卡顿。
为什么开 page: true 还是卡?后端没配合就等于白配
前端设了 page: true,但后端接口仍返回全量数据(比如 SELECT * FROM user 再 JS .slice()),Layui 依然会把全部数据转成 DOM。浏览器重排压力不减,滚动、选中、搜索全卡。
- 确认后端是否真按
page和limit参数查库(不是前端切片) - 接口响应必须含
count字段,否则分页栏不显示,Layui 会误判为前端分页 - 请求示例应为
/api/list?page=2&limit=30,不是/api/list?offset=30&size=30—— 后者需在request配置里显式映射 - 别信“我缓存了全量数据所以快”,快也没用,DOM 还是得全建
height 不设,万级数据照样白屏
Layui 2.8+ 的虚拟滚动只在表格容器有固定高度时才启用。没设 height,哪怕数据 1w 行,它也走传统全量渲染路径,主线程直接阻塞。
- 推荐写法:
height: 'full-200'(自适应减去顶部区域)或具体值如height: 500 - 避免用
min-height或 CSSheight: 100%,Layui 只认配置项里的height - 设了
height但滚动仍卡?检查是否同时开了templet函数——每行调一次 JS,1w 行就是 1w 次执行
哪些功能开着就是在拖慢渲染?
很多项目留着 toolbar: true、totalRow: true、defaultToolbar: [] 却从不点按钮,这些组件初始化时会遍历整页数据做聚合、生成 DOM 节点,纯属浪费 CPU。
-
toolbar:不用就删掉整个字段,别留toolbar: ''或toolbar: false -
totalRow:后端已算好汇总值?那就关掉,前端别再res.data.reduce() -
cols里所有templet改用字符串模板:'{{d.name}}',函数模板(templet: function(d) { return d.name + ' (' + d.status + ')'; })禁用 -
cellMinWidth别用默认60,显式设80以上,避免每列反复重算最小宽
真正卡顿的根源往往不在“数据多”,而在“前端扛了本该后端做的事”。服务端分页接口没到位、height 没设、templet 函数滥用——这三处漏掉任何一环,优化都归零。











