导出时必须显式过滤cols数组,剔除hide列、序号列(type:'numbers')、无field列及业务字段;table.cache仅含当前页数据,导出全部需调用后端接口;templet列不渲染HTML,需从cols中移除对应field。

导出时指定列不出现,必须手动过滤 cols 参数
layui 的 exportFile() 不认 hide: true,也不管你 CSS 隐藏了什么。它只按你传的 cols 数组决定导出哪些字段——哪怕这列在界面上完全看不见,只要 cols 里还留着,就会导出。
常见错误现象:表格里用 hide: true 隐藏了 id 列,导出 Excel 却发现第一列还是 ID;或者用了 $("[data-field='opt']").hide(),结果导出里“操作”列赫然在列,还全是 undefined。
- 必须显式构造一个不含目标字段的
cols一维数组(不是二维),field名要和原始数据严格一致(大小写敏感) - 如果原配置用了多级表头(
children),得先 flatten 到叶子节点再 filter,不能直接对cols[0]操作 - 别依赖
table.config.xxx.cols—— 它只存初始化快照,reload 后不会更新,要用layui.table.config.cols['yourId'][0]动态取 - 示例:去掉
opt和status_log两列:const rawCols = layui.table.config.cols['userTable'][0]; const exportCols = rawCols.filter(col => !['opt', 'status_log'].includes(col.field)); table.exportFile('userTable', table.cache.userTable, { cols: exportCols });
导出全部数据时,table.cache 只有当前页,别踩这个坑
用户点“导出全部”,结果只拿到第一页的 10 条?大概率是你直接用了 table.cache['id']。分页开启时,table.cache 永远只存当前页数据,这是设计如此,不是 bug。
真实需求是导出后端全量数据,前端无法绕过接口拉取。
- 要么让后端提供一个“导出全部”专用接口(推荐),返回完整数据数组
- 要么前端拼多次请求(不推荐,易超时、难维护),但无论如何,
table.cache不能当全部数据源用 - 如果坚持用
table.cache,至少加个提示:“当前仅导出本页数据”,避免误判
带 templet 的列,导出时默认不渲染 HTML,但字段仍存在
templet 列在导出时不会执行模板函数,而是直接取原始数据值(如 d.status),但该字段只要在 cols 里,就一定会出现在导出文件中。
想让它不导出,不是改 templet,而是从 cols 过滤掉对应 field。
- 别试图在
templet里返回空字符串来“骗过”导出——导出逻辑不看渲染结果,只看cols+data - 如果
templet返回的是 HTML 标签(比如已审核),导出后会原样显示标签字符,不是“已审核”文字 - 需要纯文本效果,应在
templet中返回d.status或加工后的字符串,而非 HTML
序号列(type: 'numbers')必须单独判断过滤
序号列没有 field,导出时不会自动跳过。如果你没手动剔除,它会作为一列导出,内容是 undefined 或空值,Excel 打开后可能显示为 0 或空白。
正确做法是在构造 exportCols 时,加一条 col.type !== 'numbers' 判断。
- 示例:
const exportCols = rawCols.filter(col => col.field && col.type !== 'numbers' && !['opt'].includes(col.field) );
- 注意顺序:先
col.field判空(排除无 field 的操作列),再col.type判序号,最后按field名过滤业务列 - 别漏掉
!col.field的情况——操作列、自定义按钮列也得一起踢掉,否则导出里会出现一整列undefined
复杂点在于:隐藏列、禁用列、templet 列、序号列,它们在 UI 层的表现逻辑各不相同,但导出时全被拉平到同一层处理——你得在 cols 这个单一入口统一决策,不能指望某个属性自动传导。











