Layui表格如何在导出Excel时加入自定义的Worksheet名称

Layui的table.exportFile()无法自定义Sheet名，因其底层硬编码为“Sheet1”；必须引入xlsx.full.min.js，用SheetJS原生API手动构造workbook，通过XLSX.utils.book_append_sheet(wb, ws, "自定义名")设置，且名称需≤31字符、禁用特殊符号。

table.exportFile() 无法设置 Sheet 名，别白费劲了

layui 的 table.exportfile() 底层硬编码了工作表名为 "sheet1"，无论你传什么参数、改什么配置、甚至在 filename 里加 #我的表，都无效。这不是 bug，是设计如此——它压根没暴露 sheet 名控制入口。

必须用 SheetJS 原生 API 手动构造 workbook

真正可控的方式，是绕过 table.exportFile()，自己调 SheetJS 的 book_new() 和 book_append_sheet()。注意三点：

• 必须引入 xlsx.full.min.js（Layui 自带的是精简版，缺 book_append_sheet）
• 数据源要用 table.cache['your-table-id']，不是 DOM 表格或 table.config.data
• Sheet 名必须满足限制：≤31 个 UTF-8 字符，禁用 / ? * [ ] 和全角符号（如“：”“【”）、emoji

示例代码：

const data = table.cache['userTable'] || [];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, "2024-员工数据.xlsx");

中文 Sheet 名乱码或报错？先查字符和符号

“员工汇总报表_2024Q2”这种名字大概率超长，SheetJS 会直接抛 "Sheet name too long"；用“员工汇总：2024”则因冒号 : 被拒绝。常见踩坑点：

• 误用全角标点（“：”“？”“【”）代替半角（":" "?" "["）
• 名字含空格过多导致截断（如“ 用户明细表 ”首尾空格也算字符）
• 在 Windows 上用旧版 Excel 打开时显示为“Sheet1”，其实是兼容性问题，不是导出失败

安全写法："用户明细"、"订单2024"、"销售汇总Q2" —— 纯半角、无特殊符号、≤10 字。

多个 Sheet 怎么追加？顺序和命名得自己管

一个 workbook 可追加多个 worksheet，但 Sheet 名不能重复，且 Excel 显示顺序 = book_append_sheet() 的调用顺序：

const wb = XLSX.utils.book_new();XLSX.utils.book_append_sheet(wb, ws1, "基础信息");XLSX.utils.book_append_sheet(wb, ws2, "操作日志"); // ← 这个会在 Excel 标签页排第二位XLSX.writeFile(wb, "综合报表.xlsx");

别指望自动按字母排序，也别在同一个 book_append_sheet() 调用里传多个 worksheet —— 它只接受单个 ws 参数。

实际导出逻辑里，Sheet 名和文件名是两件事：前者控制 Excel 标签页显示文字，后者控制下载时浏览器保存的文件名。两者都得手动设，且各自有约束，漏掉任一环节都会“看起来没生效”。