用SheetJS导出需确保仪表盘使用语义化结构，避免div模拟表格；table_to_sheet()可识别数字、日期等数据类型但丢样式；大数据量应禁用cellFormula或改服务端生成。
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
直接用 SheetJS 读取渲染后的 <table> 是最稳的路径，前提是你的仪表盘表格是真实 DOM 节点、不是纯 CSS 模拟的“假表格”。
<h3>确认仪表盘表格是语义化 <code><table> 结构
<p>很多现代仪表盘（尤其是用 React/Vue + Ant Design/Element UI 构建的）会用 <code><div> + Flex/Grid 渲染表格视觉效果。这类结构 <code>SheetJS 或任何基于 DOM 的导出方案都读不到——它只认 <table>、<code><thead>、<code><tbody>、<code><tr>、<code><th>、<code><td>。
<p>实操建议：</p>
<ul><li>打开 DevTools → Elements 面板，搜索 <code><table>，确认目标表格存在且层级干净（没有 <code><table> 套 <code><table>，<code><tr> 里没塞 <code><div>）
<li>如果用的是 ECharts / Chart.js 等图表库，它们本身不生成表格；需额外提供一个“数据表格”区域（哪怕 <code>display: none），并确保该区域是标准 <table>
<li>Vue 项目中注意 <code>v-if 或 key 变化可能导致 DOM 未就绪，导出前加 await nextTick()；React 中用 useEffect 确保 ref 已挂载
XLSX.utils.table_to_sheet() 不能保留样式但能保数据类型
这个函数只提取单元格文本内容和 rowspan/colspan，所有内联样式、CSS 类、背景色、字体都会丢。但它会自动识别常见格式：带千分位的数字（如 1,234.56）转为数值，2026-10-27 转为日期，开头带单引号的（'00123）强制为文本——这对后续 Excel 分析很关键。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 避免在
<td> 里写 <code>style="color: red"之类无意义的样式，导出时白费力气 - 长数字（如身份证、订单号）必须加
style="mso-number-format:'@'"或用单引号前缀，否则 Excel 会转成科学计数法（1234567890123456789→1.23457E+18） - 中文表头没问题，但若导出后乱码，检查页面
<meta charset="UTF-8">是否存在（SheetJS不依赖它，但某些旧 IE 场景需要） - 显式关闭公式解析：
XLSX.writeFile(wb, "dashboard.xlsx", { cellFormula: false }) - 如果真有公式需求（比如汇总行），不要靠自动识别，改用
cell.f = "=SUM(A2:A100)"手动赋值 - 超 1 万行建议切分：前端导出仅限查看用途，正式报表走服务端生成（Python
pandas+openpyxl更可靠） - 响应头必须包含：
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet -
Content-Disposition必须用filename*=UTF-8''%E6%95%B0%E6%8D%AE.xlsx格式（注意filename*=后是 URL 编码的文件名），不能只写filename="数据.xlsx"，否则 Safari 和部分 Chrome 会乱码或拒下 - Node.js 示例：
res.setHeader("Content-Disposition", `attachment; filename*=UTF-8''${encodeURIComponent("仪表盘数据.xlsx")}`)
大数据量（>3000 行）要禁用公式解析
XLSX.writeFile() 默认启用 cellFormula: true，它会对每格内容做公式检测（比如以 = 开头就当公式）。这在大表格里会明显卡顿，甚至导致浏览器无响应。
实操建议：
服务端导出时 Content-Disposition 头必须带 filename*=
仪表盘前端传 JSON 给后端，后端生成真实 .xlsx 文件返回，这是规避所有前端限制的终极方案。但 90% 的失败都卡在响应头。
实操建议：
真正容易被忽略的是：仪表盘里常有“动态列”（比如按时间范围切换显示周/月维度），导出前必须确保当前视图的数据已完整渲染进 <table>，而不是靠 JS 临时拼字符串插入 —— 后者 DOM 里根本找不到，<code>table_to_sheet() 读出来就是空。
