如何配置Layui表格导出Excel，实现每页固定行数导出？

本文共计967个文字，预计阅读时间需要4分钟。

相关专题：

layui 自带导出不支持设置打印时每页重复的标题行。它生成的是 csv 文件（即使后缀是 .xlsx），excel 打开时只是用 csv 渲染，压根不读取「页面布局 → 打印标题」这类设置。想让导出的 excel 每页都显示表头，必须换方案。

为什么 exportFile() 导出的文件无法设置每页标题行

导出本质是拼 CSV 字符串 + UTF-8 BOM 头 + download 触发下载。CSV 没有「工作表属性」「分页控制」或「打印标题」概念。Excel 用 CSV 打开时，所有格式、页面设置全丢失。你手动在 Excel 里点「页面布局 → 打印标题」能生效，但那是你在本地改，不是导出时带进去的。

• 导出后双击打开 → 看到的是纯数据，无任何打印设置
• 右键另存为 .xlsx 再去设打印标题 → 可以，但这不属于“导出时设置”
• 试图在 exportFile() 参数里传入 sheetName 或 filename 来影响打印行为 → 完全无效

真正可行的替代方案：用 xlsx.js 生成原生 .xlsx

只有生成真正的 Excel 文件（.xlsx），才能写入 PageSetup.PrintTitleRows 属性。xslx.js 支持该能力，且与 Layui 兼容良好。

• 引入：<script src="https://cdn.jsdelivr.net/npm/xlsx@0.18.5/dist/xlsx.full.min.js"></script>
• 获取数据：用 table.checkStatus('yourId').data 或 getSelections() 拿原始对象数组
• 构造表头映射：按 cols 顺序提取 title 做 header 行，再 map 每行数据字段值（注意 templet 渲染逻辑要手动还原）
• 生成 sheet：XLSX.utils.json_to_sheet(dataWithHeader, {header: headers})
• 关键一步：设置打印标题行：

  const ws = XLSX.utils.json_to_sheet(...);<br>ws['!print'] = {scale: 100, title: '用户数据报表', hCenter: true};<br>ws['!pageSetup'] = {paperSize: 9, orientation: 'portrait'};<br>ws['!margins'] = {top: 0.75, bottom: 0.75, left: 0.7, right: 0.7, header: 0.5, footer: 0.5};<br>ws['!rows'] = [{hpt: 24}]; // 可选：设第一行为 24pt 高<br>// ⚠️ 注意：xlsx.js 不直接暴露 PrintTitleRows 设置，需手动写入 row 对象的 '!outline' 或用 SheetJS Pro；免费版中更可靠的做法是——把标题行复制到每一页顶部（见下条）

最稳的落地做法：导出前把标题行作为首行 + 启用 Excel 的「顶端标题行」功能

既然无法在 JS 里写死 PrintTitleRows，就导出一个结构清晰的 .xlsx，让用户（或运营人员）自己点一下设置。重点是让这个操作「零门槛」：

• 导出文件名别用 export.xlsx，改成 用户数据报表_请开启打印标题.xlsx，在名字里提示动作
• 确保第一行就是完整中文表头（title 字段已设好），且无空行、无合并单元格
• 在系统文档或按钮 hover 提示里写明：“导出后，请在 Excel 中点击【页面布局】→【打印标题】→【顶端标题行】→ 选中第1行 → 确定”
• 如果必须全自动，只能走服务端生成（如用 Apache POI / EPPlus），前端 JS 无法绕过浏览器沙箱写入 Excel 打印属性

真正卡住的点从来不是“怎么写代码”，而是 CSV 和 .xlsx 的本质差异。别在 exportFile() 上反复试错——它连字体都设不了，更别说打印标题了。