导出必须基于筛选后的数据而非原始HTML;应维护可见数据数组,用SheetJS导出Excel,按钮需禁用并加加载态,大数据量建议后端导出且确保前后端筛选逻辑一致。

导出前必须先拿到筛选后的数据,而不是原始 HTML 表格
很多人直接对 常见错误现象: 手拼 CSV 字符串容易崩:含逗号、换行、中文、双引号的单元格会错位;而浏览器原生 使用场景: 用户点击导出后无反馈,容易连点;而 SheetJS 处理 5000+ 行时在低端设备上可能卡顿 1–2 秒,期间若重复触发会生成多个文件或报错 前端导出受限于内存(Chrome 对单次 Blob 约 500MB 上限)和性能(>5 万行易卡死)。真实业务中,导出应走后端接口,前端只传筛选条件。 关键点: 最容易被忽略的是:前端筛选 UI 和后端查询逻辑必须严格一致。比如前端用 元素调用
document.querySelector('table').outerHTML 导出,结果发现导出的是全部数据——因为 DOM 没变,只是部分 被 display: none 隐藏了。导出逻辑必须和筛选逻辑耦合:筛选时应维护一个「当前可见数据数组」,导出时只处理这个数组。
• 点击导出,Excel 里全是原始数据
• 筛选后行数变少,但导出文件行数没变
• 导出内容包含被隐藏的敏感字段(比如后台 ID)
filteredData 数组)用 SheetJS(xlsx.js)导出为 Excel 最稳,别手写 CSV
download 属性不支持 Excel 格式。SheetJS 是事实标准,体积小(xlsx.min.js 约 150KB),API 直观。
• 需要保留数字格式(如 123456789 不变成 1.23E+8)
• 列名含中文或特殊符号
• 后续可能加样式或多 sheet
<script src="https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/xlsx.min.js"></script>
const ws = XLSX.utils.json_to_sheet(filteredData);<br>const wb = XLSX.utils.book_new();<br>XLSX.utils.book_append_sheet(wb, ws, "数据");<br>XLSX.writeFile(wb, "筛选结果.xlsx");
json_to_sheet 默认按对象第一个元素的 key 排列列顺序,若需固定列序,传
{header: ['name', 'status', 'amount']}导出按钮必须禁用 + 加载态,尤其数据量大时
RangeError: Maximum call stack size exceeded(因大量对象递归序列化)。
disabled 和 loading 文字:
btn.disabled = false; btn.textContent = '导出 Excel';
后端导出更可靠,但需同步筛选参数
• 前端筛选条件(如日期范围、状态数组、关键词)必须原样透传给后端
• 接口返回 Content-Disposition: attachment; filename="xxx.xlsx"
• 前端用 fetch + response.blob() 触发下载
new Date().toISOString().split('T')[0] 生成日期,后端却按 UTC+8 解析,导出时间就错了一天。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











