直接在render()前调用$.ajax会失败，因为layui.table.render()是同步执行的，而列配置等需异步获取，必须等AJAX返回后再调用render()，否则cols为空导致报错或渲染错乱。
为什么直接在 render() 前调用 $.ajax 会失败
因为 layui.table.render() 是同步执行的，而外部配置（比如列宽、字段别名、是否显示某列）通常需要异步请求后才能确定。如果你在 render() 前写个 $.ajax，但没等它返回就直接 render，cols 或 width 就还是空或默认值——表格要么渲染错乱，要么报 uncaught typeerror: cannot read property 'length' of undefined。
必须等配置加载完再调用 table.render()
核心是把 table.render() 放进异步回调里，而不是放在外层同步流程中。常见写法误区是用 async/await 包裹 render() 却没处理好 layui 的模块加载时机。
- 推荐用
layui.use(['table', 'jquery'], function(){...})先确保模块就绪 - 再用
$.get('/api/table/config')或fetch()拿配置，成功后再调table.render() - 配置数据建议结构化：包含
cols数组、height、url等字段，避免硬编码拼接 - 注意：
cols中的field必须和后端返回的 JSON 字段名完全一致，大小写敏感
table.init() 不适用，别被文档误导
有人查文档看到 table.init()，以为能“预设”配置，其实它只用于绑定事件代理（比如工具条点击），不参与列定义或数据加载逻辑。调用它不会延迟或拦截 render()，也无法注入异步拿到的 cols。
-
table.init('test', {...})的第二个参数是事件配置对象，不是表格基础配置 - 想动态改列？得用
table.reload()，但首次渲染仍需等配置就绪 - 若强行先
render()再reload()，会触发两次请求，且首屏闪动明显
如何安全地合并默认列与动态配置
实际项目中，往往一部分列固定（如 ID、操作），另一部分由后端控制（如是否显示“审核人”、“备注”）。这时别全量替换 cols，而是做浅合并。
const defaultCols = [
{type: 'checkbox'},
{field: 'id', title: 'ID', width: 80},
{field: 'op', title: '操作', toolbar: '#barDemo'}
];
// 假设后端返回 { "dynamicCols": [{field:'name',title:'姓名'}, {field:'dept',title:'部门'}] }
const finalCols = defaultCols.concat(config.dynamicCols);
table.render({
elem: '#demo',
cols: [finalCols],
url: '/api/data'
});
注意：如果后端返回的是完整 cols（含 checkbox 和操作列），那就直接用它；否则合并时要检查重复 field，避免渲染异常。
table is not defined 或列丢失。
