必须使用 SheetJS 原生 API 手动构造 workbook 并通过 XLSX.utils.book_append_sheet(wb, ws, "自定义名") 设置 sheet 名，Layui 的 exportFile() 不支持自定义名称。
导出时 sheet 名称始终是“Sheet1”怎么办
Layui 的 table.exportFile() 默认不支持自定义 sheet 名称，它底层调用的是 SheetJS（xlsx），但 Layui 封装时把工作表名硬编码成了 "Sheet1"，所以无论你传什么参数，导出的 Excel 里 sheet 标签永远显示为“Sheet1”。
真正能改名的方式，是绕过 table.exportFile()，自己构造 workbook 并调用 SheetJS 原生 API。你需要手动提取表格数据、生成 worksheet，再用 XLSX.utils.book_new() 和 XLSX.utils.book_append_sheet() 控制 sheet 名。
- 别试图在
exportFile()的filename参数里加 sheet 名（比如"报表_2024.xlsx#自定义名"），无效 - 不要改 Layui 源码里的
"Sheet1"字符串——升级后就丢，且多表格共存时容易冲突 - 必须引入完整版
xlsx.full.min.js（Layui 自带的是精简版，缺book_append_sheet等关键方法）
用 xlsx.full.min.js 手动导出并指定 sheet 名
先确保页面已加载完整 SheetJS：
<script src="https://cdn.jsdelivr.net/npm/xlsx@0.18.5/dist/xlsx.full.min.js"></script>然后用以下逻辑替代默认导出：
核心步骤：
- 用
table.cache['your-table-id']拿到当前表格的原始数据（注意：不是 DOM 表格内容，是 Layui 缓存的 JSON 数组） - 用
XLSX.utils.json_to_sheet(data)转成 worksheet - 用
XLSX.utils.book_new()新建 workbook - 用
XLSX.utils.book_append_sheet(wb, ws, "我的报表")追加工作表，第二个参数是 sheet 名（最长 31 字符，不能含\ / ? * [ ]） - 最后调
XLSX.writeFile(wb, "导出.xlsx")
示例片段：
const data = table.cache['demo']; // 替换为你的 table id const ws = XLSX.utils.json_to_sheet(data); const wb = XLSX.utils.book_new(); XLSX.utils.book_append_sheet(wb, ws, "用户汇总"); // ← 这里就是 sheet 名 XLSX.writeFile(wb, "用户数据.xlsx");
中文 sheet 名乱码或截断？检查字符限制和编码
SheetJS 对 sheet 名有严格限制：最多 31 个 UTF-8 字符（不是字节数），且禁止使用 \ / ? * [ ] 和控制字符。中文算一个字符，但某些旧版 Excel 在 Windows 上可能对非 ASCII 名兼容性差。
- 如果名称超长（如
"2024年Q3华东区销售明细报表"），会被自动截断或报错"Sheet name too long" - 出现乱码通常是因为你用了全角符号（如“：”“【”）或 emoji，SheetJS 不认，直接抛异常
- 动态生成名称时务必过滤：
const safeName = name.replace(/[\u005C\u002F\u003F\u002A\u005B\u005D]/g, "").slice(0, 31);
导出多个 sheet 时怎么分别命名
一个 workbook 可以 append 多个 worksheet，每个调 book_append_sheet() 时传不同名字即可。常见场景如：分页导出、多 tab 表格、主子表合并导出。
- 每张 sheet 数据必须是独立的二维数组或 JSON 数组，不能复用同一个
ws对象 - 重复调用
book_append_sheet()即可，顺序即 Excel 中 tab 顺序 - 注意内存：大数据量时别一次性生成所有 sheet，容易卡死；可考虑分 chunk 或服务端导出
例如导出两个 sheet：
const wb = XLSX.utils.book_new(); XLSX.utils.book_append_sheet(wb, ws1, "基础信息"); XLSX.utils.book_append_sheet(wb, ws2, "操作日志"); XLSX.writeFile(wb, "综合报表.xlsx");
Layui 本身不提供 sheet 命名能力，所有自定义都得走 SheetJS 原生路径。最容易被忽略的是：xslx.full.min.js 必须显式引入，且 sheet 名的合法性校验要前置——不然导出失败时连错误提示都没有，只看到下载中断。
