table.exportFile() 的 filename 参数需在表格渲染完成后手动调用时传入对象，如 table.exportFile('userTable', data, { filename: '2024-用户报表.xlsx', type: 'xlsx' })，且必须带扩展名、避免重复后缀；推荐用 Blob + BOM 头方式实现中文名等定制需求。
table.exportFile() 的 filename 参数怎么传才生效
直接传对象，但必须在表格渲染完成后、导出动作触发时调用，不能塞进 table.render() 配置里。很多人写了 filename: '用户报表.xlsx' 却没效果，就是因为放错了位置。
- 正确调用方式：
table.exportFile('userTable', data, { filename: '2024-用户报表.xlsx', type: 'xlsx' })，其中'userTable'是表格的lay-id值（优先于 DOM ID） -
filename必须带扩展名（.xlsx或.csv），否则浏览器可能默认为.xls或解析失败 - 如果用了工具栏监听（如
table.on('toolbar(test)', ...)），记得return false阻止默认导出，再手动调用exportFile() - Layui 2.8+ 支持
done回调，可在回调里拦截并改用 Blob 下载（尤其适合 CSV 中文名）
不想改源码？用 Blob + URL.createObjectURL 替代默认下载
这是最稳妥、无需动任何 JS 文件的方式，特别适合处理中文文件名、避免后缀重复、或需要动态拼接时间戳等场景。
- CSV 中文名乱码根本原因是
Content-Disposition在旧版 IE/Edge 中不支持 UTF-8 编码，Layui 内置的encodeURIComponent也救不了 - 构造 Blob 时务必加 BOM 头：
const csvString = '\uFEFF' + yourCsvContent，否则 Excel 打开会乱码 - 示例片段：
const blob = new Blob(['\uFEFF' + csvData], { type: 'text/csv;charset=utf-8;' });<br>const url = URL.createObjectURL(blob);<br>const a = document.createElement('a');<br>a.href = url;<br>a.download = '订单汇总-20240421.csv';<br>a.click();<br>URL.revokeObjectURL(url); - 这个方式完全绕过
table.exportFile()，所以不受其参数限制，也不依赖 Layui 版本
改源码能一劳永逸？先看清代价
网上流传的“修改 table.js 中 exportFile 函数，加第四个参数”确实可行，但风险明确：升级 Layui 后立即失效，且多人协作时容易漏同步。
- 要改两处：一是函数签名从
d.exportFile = function(e,t,i)改为d.exportFile = function(e,t,i,name)；二是找到s.download = (l.title || "table_" + ...)这行，改成s.download = (name || l.title || "table_" + ...) - 改完后调用写法是：
table.exportFile('id', data, 'xlsx', '我的报表')—— 注意第四个参数是纯字符串，不带.xlsx - 但 Layui 自带的精简版
xlsx.min.js不支持自定义 Sheet 名，如果你后续还要改 Sheet 标签，仍得引入xlsx.full.min.js并手动构造 workbook - 多表格共存时，若多个地方都改了同一份源码，极易因命名冲突或逻辑覆盖导致导出异常
文件名里的常见坑：后缀、编码、长度
看似简单，实则三处最容易翻车：重复后缀、BOM 缺失、超长截断。
- 别写
filename: '用户报表.xlsx.xlsx'——table.exportFile()会自动加后缀，你再写就变成双重扩展名，下载后打不开 - CSV 必须加
\uFEFFBOM 头，哪怕只是本地测试；Excel 对无 BOM 的 UTF-8 CSV 极其不友好 - 文件名总长度（含路径）在某些 Windows 环境下有上限，建议控制在 60 字符内，避免
用户数据报表_2024年Q2华东区销售明细汇总_v2_final.xlsx这类命名 - 如果导出前做了筛选，把条件拼进文件名很实用，例如：
filename: `用户-${status}-报表.xlsx`，但注意status要做基础校验，防注入或非法字符
