toolbar值必须是带#的模板ID或合法HTML字符串，否则按钮不显示或无响应；事件监听需严格匹配filter名，图标失效多因iconfont加载失败，操作行数据应使用列工具栏而非表格工具栏。
直接在 toolbar 配置里写 HTML 字符串或 <i class="layui-icon"> 标签，按钮会渲染成纯文本——图标不显示、点击无响应，这是最常卡住的地方。
toolbar 值必须是模板 ID 字符串（带 #）或合法 HTML 字符串
layui 不解析 toolbar 字段里的 HTML 片段，除非你明确告诉它“这是模板”。传错类型，按钮就静默消失：
-
toolbar: true或toolbar: 'default'→ 只显示内置的筛选、导出、打印三个按钮 -
toolbar: '#myToolbar'→ 正确：指向一个<script type="text/html" id="myToolbar">模板 -
toolbar: '<button lay-event="export">导出</button>'→ 可用但不推荐，难维护、易 XSS、无法复用 -
toolbar: 'myToolbar'（漏掉 #）→ 模板找不到，工具栏空白，控制台无报错 -
toolbar: '#my-toolbar'（ID 含短横线）但模板 ID 是myToolbar→ 大小写或符号不一致，匹配失败
模板里必须用 lay-event，监听必须用 table.on('toolbar(filter)')
按钮能显示 ≠ 能点击。事件链断裂一个环节，点击就完全失效：
- 模板中按钮必须带
lay-event="refresh"这类值，且只能是合法 JS 标识符（不能含空格、中文、短横线） -
<table>标签上必须有lay-filter="userTable"，这个字符串就是 filter 名 - 监听代码必须严格写成
table.on('toolbar(userTable)', callback)，括号里是 filter 值，不是模板 ID 也不是表格 ID - 回调函数中通过
obj.event === 'refresh'判断触发了哪个按钮，obj.event就是lay-event的值
图标不显示？先查字体文件是否加载成功
按钮文字可见、hover 有效，但 <i class="layui-icon"> 位置空白，90% 是 iconfont 加载失败：
- 打开浏览器开发者工具 → Network 面板 → 过滤
icon或font - 看是否有
layui.css引用的iconfont.woff2等资源返回 404 - 常见原因：项目用了自定义 layui 路径，但
layui.css里写的字体路径还是相对默认路径（如../font/iconfont.woff2） - 临时验证：在控制台执行
getComputedStyle(document.querySelector('.layui-icon')).fontFamily，返回值如果不是"layui-icon"，说明字体未生效
想操作选中行？别在 toolbar 按钮里硬凑
toolbar 是表格级区域，点击时 this 指向按钮 DOM，obj.data 是 undefined：
- 要获取当前选中行，请手动调用
table.checkStatus('userTable').data - 要操作单行（比如编辑某一行），这个按钮就不该放 toolbar，而应放进列配置：
{ field: 'operate', toolbar: '#rowBar' } -
#rowBar模板里按钮的点击事件由table.on('tool(userTable)', callback)监听，回调中obj.data才是当前行完整数据 - 强行在 toolbar 里查
obj.data会得到undefined，这是新手最常白忙活一小时的地方
真正麻烦的不是写几行 HTML，而是 filter、lay-event、监听器三者严丝合缝；漏一个字符，整个按钮就变成摆设。
