「列表能不能导出 Excel」——后台管理系统绕不开的需求。三种方案,各有明确的适用边界。
方案一:CSV 直出(最轻)
数据拼接成 CSV 字符串,加 BOM 头(,否则 Excel 打开中文乱码)后下载。零依赖、几行代码。
适合:纯数据列表、无样式要求、列数不多。别碰:需要表头样式、多 Sheet、单元格合并的场景——CSV 没有这些能力。
坑两个:值里含逗号/引号/换行的字段必须用引号包裹并转义(手拼字符串的高频翻车点);数字长字段(订单号、身份证)Excel 会转科学计数法——CSV 场景无解,这是方案一的天花板。
方案二:前端库生成 xlsx
SheetJS(xlsx)或 exceljs 在浏览器直接生成真正的 xlsx。能设置表头样式、列宽、多 Sheet、单元格格式,大数字可指定为文本格式规避精度丢失。
适合:绝大多数后台导出需求,样式要求中等的。注意:exceljs 的样式 API 与 SheetJS 免费版差异大,选型时先确认样式需求再定库;几十万行的大表在前端生成会卡主线程,进 Web Worker 或转方案三。
方案三:服务端生成
前端传查询条件,后端流式生成 xlsx 返回。
适合:大数据量(十万行级)、需要复杂样式(合并单元格、官方模板)、需要留痕归档的导出。前端只管发起请求和接收文件流。
分片导出的实现要点:服务端用流式写入(exceljs 的 streaming 模式)逐行写,避免整表载入内存;前端用 fetch+blob 接收并显示进度。超时风险高的(百万行)改异步任务+通知下载。
选型一句话
无样式小数据选 CSV;中等数据要样式选前端库;大数据或复杂样式走服务端。三个方案可以共存于一个系统——按导出场景分别选,不必全局统一。
三个高频坑
- 大数精度:JS 的 Number 在 16 位以上丢精度,订单号务必按字符串处理;
- 日期格式:Excel 的日期是序列值,字符串日期写入后不会被识别——按业务需要决定要不要转;
- 文件名乱码:Content-Disposition 里的中文文件名要 encodeURIComponent,否则部分浏览器显示乱码。