单行表头需用一维数组传入cols，每个对象必须含field和title，顺序决定列序，field须与数据字段名完全一致；禁用排序加sort:false；宽度异常时显式设width或minWidth。
table.render 的 cols 参数怎么写才有效
单行表头不需要任何 hack，直接用一维数组传给 cols 就行。layui 2.8+ 的 table.render() 明确只认最外层数组为“表头行”，内层数组会被当成同一行里的多个列平铺——所以别嵌套，也别写成二维数组。
常见错误是照抄旧文档或混淆了「多级表头」写法，比如：
cols: [[{field: 'id', title: 'ID'}, {field: 'name', title: '姓名'}]] // ❌ 错！这是二维，会被当“1行2列”渲染，但结构冗余且易出错
正确写法是：
cols: [{field: 'id', title: 'ID'}, {field: 'name', title: '姓名'}, {field: 'status', title: '状态'}] // ✅ 对，就是一维数组
- 每个对象必须含
field（对应数据字段名）和title（表头文字），否则列不显示 - 顺序决定列顺序，
field必须和后端返回或本地data数组中对象的 key 完全一致（区分大小写） - 如果某列要禁用排序，显式加
sort: false；默认是true但没开启lay-event或绑定tool列时，点击标题不会触发排序
为什么加了 cols 却看不到表头
大概率是 DOM 节点没匹配上，或者 elem 选中的是一个空容器。
- 确保 HTML 中存在对应
id的<table> 标签，且没被其他 JS 提前清空或覆盖 <li> <code>elem值必须是 CSS 选择器，推荐用'#myTable'这种 id 选择器，避免用类名或标签名导致多匹配 - 如果用了自动渲染（即
<table class="layui-table" lay-data="{...}">），就别再调 <code>table.render()，二者冲突 - 检查浏览器控制台有没有报错，比如
table is not defined（漏了layui.use('table', ...)）或elem undefined（选择器写错） - 给每列显式加
width，单位是像素，例如{field: 'name', title: '姓名', width: 120} - 总宽度超出容器时，表格会自动出现横向滚动条；若不想滚动，可设
width总和 ≤ 容器宽度，并加height让内容区可滚动 - 中文表头文字偏长？加
minWidth防止被压缩过窄，比如minWidth: 80 - 别在 CSS 里强行改
thead th的width，Layui 渲染后会内联 style 覆盖，优先用配置项控制 - 重 render 前，先缓存当前页码、排序字段、搜索关键词等状态，否则刷新后全丢
- 传入的
data必须是当前页完整数据（不能只传新表头），否则表格变空 - 如果原表启用了分页，重 render 时建议保持
page: true并传入limit和curr，否则会跳回第一页 - 更轻量的做法：只改
thead文字内容，用 jQuery 找到对应th元素并更新innerText，但要注意保留data-field属性，否则排序/导出功能失效
表头文字对不齐、宽度异常怎么办
不是样式问题，而是 Layui 默认按内容自适应宽度，且未设 width 时列宽由内部算法分配，容易挤在一起或拉太开。
动态改表头（比如切换语言）要不要重 render
要。Layui 没提供更新表头的 API，table.reload() 也不管 cols，只能重新调 table.render()。
title 里，换语言就得改 JS；或者漏设 field 导致导出 CSV 时列名错位。这些细节，比“怎么显示出来”更值得花两分钟想清楚。
