layui固定列需同时满足四个条件:fixed必须写在columns开头或结尾、每列显式设width、配置height为具体数值、列位置严格连续;缺一不可,否则错位或失效。

fixed: 'left' 必须连续写在 columns 开头,且每列都要显式设 width
左侧固定列不是“选中哪几列就固定哪几列”,而是按定义顺序从左往右堆叠。只要中间插了一个没设 fixed: 'left' 的列,后续的左固定列就会失效或错位。
- 两列左固定必须都写在
cols[0]数组最前面,彼此紧邻 - 每列都必须配
width(比如width: 100),不能只靠minWidth或留空 - 避免把
type: 'checkbox'或type: 'numbers'放在左固定区中间——它们本身会自动加fixed: 'left',但不占你写的索引位置,容易打乱宽度计算 - 如果用了多级表头(
cols: [[{title:'分组', children: [...] }]]),fixed必须写在叶子列(即最内层数组的项)上
fixed: 'right' 只能放在 columns 末尾,且只能有一个“右固定区”
layui 不支持多个 fixed: 'right' 列并列,它会把从第一个 fixed: 'right' 开始的所有后续列都塞进右侧容器——但只有最后一列能正常显示,其余大概率宽度假、内容错乱甚至报 Cannot read property 'width' of undefined。
- 操作列必须是
cols[0]数组的**最后一个元素** - 必须显式写
fixed: 'right',大小写敏感,不能是true或'Right' - 同样要设
width(如width: 160),避免用百分比或minWidth - 如果想让“操作”视觉上居右但又带一列状态列(如“审核状态”),建议把状态列也设为
fixed: 'right',然后在templet里合并渲染,而不是拆成两列
height 是开关,不是可选项
没设 height,固定列就只是普通列——横向滚动条不出,左右容器不激活,三容器分离机制根本没启动。
-
height必须是具体数值,比如height: 450,不能是'auto'、'100%'或max-heightCSS - 高度要足够撑出垂直滚动条,否则即使写了
height: 200,内容不满也会导致固定失效 - 如果表格嵌在弹窗或折叠面板里,确保父容器没设
overflow: hidden,否则右侧固定列会被裁掉
左右固定列总宽不能压过表格总宽
所有 fixed 列的 width 加起来,如果超过 table.render() 配置的 width 值(如有),或者超出父容器实际可用宽度,就会触发额外的横向滚动,导致“固定列跟着滚”的假象。
- 建议显式设
width: 1200(根据业务定),并确保左固定两列 + 右操作列的width总和 ≤ 这个值 - 中间常规列可只设
minWidth,由 layui 自动均分剩余空间 - 用浏览器 DevTools 检查
.layui-table-fixed-l和.layui-table-fixed-r的实际宽度,和对应列配置的width是否一致——不一致说明有其他 CSS 干扰或配置冲突
fixed + width + height + 列位置 四者严丝合缝。漏一个,轻则错位抖动,重则整个固定区消失。尤其要注意:左右固定列不能跨区混排,也不能指望它像 Excel 那样“冻结中间某列”——那不是功能缺失,是架构上就不允许。


















