不依赖第三方库,JS怎么用Blob导出Excel

作者:像素漫游

时间:2026-11-22

浏览:296

详细讲解在不依赖任何第三方库的前提下,使用原生JavaScript通过Blob对象实现导出Excel的完整方案,涵盖CSV注入BOM防乱码、HTML伪装表格排版、XML 2003多Sheet构建以及核心排坑技巧。

文章目录
不依赖第三方库,JS怎么用Blob导出Excel
图 0:纯原生 JavaScript 通过 Blob 导出 Excel 的完整执行架构

在前端业务开发中,导出 Excel 是极其常见的报表需求。绝大多数项目习惯直接引入 SheetJS(xlsx)、ExcelJS 等第三方依赖,但这些库打包体积通常在数百 KB 甚至数 MB。如果你的业务仅仅是导出常规的数据清单、统计表格或简单的排版报表,完全无需引入任何外部库:利用浏览器原生支持的 Blob(Binary Large Object,二进制大对象)容器,封装符合 Excel 兼容规范的纯文本、HTML 或 XML 数据,再配合 URL.createObjectURL 与隐藏的下载超链接,即可毫秒级生成并导出可被 Microsoft Excel 和 WPS 完美识别的电子表格文件。

一、原生导出 Excel 的底层原理与格式选择

很多开发者误以为“导出 Excel”必须生成标准的 .xlsx 格式(实质上是一个经过 ZIP 压缩的 XML 文件集合,纯手工拼装成本极高)。但事实上,Microsoft Excel 从早期版本起就内置了极其包容的文件格式解析引擎。在没有第三方依赖的前端环境下,浏览器可以直接输出以下三种能被 Excel 正确打开的格式:

  • CSV 文本格式(.csv):以逗号分隔字段、换行分隔行记录的轻量纯文本。体积最小、生成性能最高,但不能设置样式和多 Sheet。
  • HTML Table 伪装格式(.xls):将包含标准 <table>、<tr>、<td> 的 HTML 代码保存为 .xls 后缀,并声明特定的 MIME 类型。Excel 会以网页渲染引擎将其解析为工作表,天然支持单元格合并、文字对齐和字体颜色。
  • XML 电子表格 2003 格式(.xml 或 .xls):微软官方的 SpreadsheetML 规范。它支持真正的多工作表(Multi-Sheet)、冻结窗格以及严格的单元格数据类型定义(String、Number、DateTime)。

构建好这三类结构化文本后,前端通过 new Blob([content], { type: mimeType }) 在浏览器内存堆中分配一段只读的原始二进制存储块,再将该块映射为可供浏览器下载的虚构 URL,最终拉起系统的文件保存对话框。

不依赖第三方库,JS怎么用Blob导出Excel
图 1:原生 JS 导出 Excel 的三条格式路线与 Blob 桥梁

二、标准下载流水线:通用 Blob 下载函数封装

无论后续选择哪一种格式,数据拼装完成后的“Blob 封装与触发下载”逻辑是完全一致的。我们首先将这段生命周期封装为一个标准、健壮的工具函数 downloadBlobFile,供所有导出场景复用:

/**
 * 触发浏览器下载 Blob 二进制文件的通用方法
 * @param {string|ArrayBuffer} content 文件内容
 * @param {string} filename 保存的文件名(含后缀)
 * @param {string} mimeType 媒体类型
 */
function downloadBlobFile(content, filename, mimeType) {
  // 1. 实例化 Blob 对象
  const blob = new Blob([content], { type: mimeType });

  // 2. 为 Blob 资源生成唯一的内存映射 URL
  const objectUrl = URL.createObjectURL(blob);

  // 3. 动态创建隐藏的 a 标签模拟用户点击下载
  const downloadLink = document.createElement('a');
  downloadLink.href = objectUrl;
  downloadLink.download = filename;
  downloadLink.style.display = 'none';
  document.body.appendChild(downloadLink);

  // 4. 派发点击事件
  downloadLink.click();

  // 5. 移除 DOM 节点并在延迟后安全释放内存 URL
  document.body.removeChild(downloadLink);
  setTimeout(() => {
    URL.revokeObjectURL(objectUrl);
  }, 1000);
}

避坑细节:为什么必须延迟调用 URL.revokeObjectURL?
很多代码示例在执行 downloadLink.click() 后立即紧随调用 URL.revokeObjectURL(objectUrl)。在部分执行速度较慢的设备或特定的移动端 WebView 中,浏览器的下载调度是异步的。如果同步撤销 URL,可能导致底层实际发起读取时该内存映射已被销毁,最终造成静默下载失败或下载出 0 字节损坏文件。使用 setTimeout 给予 1 秒缓冲是标准的防护方案。

不依赖第三方库,JS怎么用Blob导出Excel
图 2:原生 Blob 导出 Excel 的标准 5 步执行流程

三、方案一:CSV 纯文本导出(轻量与中文防乱码)

对于数据量庞大、仅包含二维行列数据的查询结果导出,CSV 是最简洁、消耗资源最少的选择。但在实践中,很多初学者导出的 CSV 用 Excel 打开往往会出现两大致命问题:中文全变成乱码,以及身份证号、订单号被截断为科学计数法。

1. 解决中文乱码:注入 UTF-8 BOM 标记

Windows 环境下的 Excel 打开 CSV 时,默认采用操作系统的本地 ANSI/GBK 编码进行解码,而现代浏览器环境下的 JavaScript 字符串统一采用 UTF-8 编码。当编码不匹配时,中文必然呈现为乱码。解决办法是在 CSV 字符串最前面加上 UTF-8 BOM(Byte Order Mark) 标识 (十六进制为 EF BB BF)。Excel 一旦检测到该标记,就会强制按 UTF-8 规则进行解码。

2. 解决字段内逗号、换行与长数字变形

如果数据内容本身包含英文逗号 , 或换行符 ,必须使用英文双引号 " 将该字段包裹;如果内容中已有双引号,则需替换为两个连续的双引号 ""。另外,对于超过 11 位的纯数字(例如身份证号、银行卡号、物流单号),Excel 会自动转为 1.23456E+17,超过 15 位更会将尾数强制变为 0。在导出时,在长数字后面追加一个制表符 ,Excel 就会将其强制视为纯文本处理,不改变原始精度。

/**
 * 导出 CSV 格式数据(不依赖任何第三方库)
 * @param {string[]} headers 表头数组
 * @param {Array} rows 数据源
 * @param {string} filename 导出文件名
 */
function exportToCSV(headers, rows, filename = 'export.csv') {
  // 字段安全过滤转换
  const formatCell = (val) => {
    if (val === null || val === undefined) return '""';
    let str = String(val);

    // 针对长数字或以 0 开头的编号,添加 \t 强制以文本模式展示
    if (/^\d{12,}$/.test(str) || /^0\d+$/.test(str)) {
      str = str + '\t';
    }

    // 如果包含双引号、逗号或换行符,进行标准双引号转义
    if (/[",\n\r]/.test(str)) {
      return `"${str.replace(/"/g, '""')}"`;
    }
    return `"${str}"`;
  };

  // 1. 拼装表头与数据行
  const csvLines = [];
  csvLines.push(headers.map(formatCell).join(','));

  rows.forEach(row => {
    const rowValues = Array.isArray(row) ? row : headers.map(h => row[h]);
    csvLines.push(rowValues.map(formatCell).join(','));
  });

  // 2. 关键:在内容首部添加 UTF-8 BOM 标识 (\uFEFF)
  const csvContent = '\uFEFF' + csvLines.join('\r\n');

  // 3. 触发 Blob 下载
  downloadBlobFile(csvContent, filename, 'text/csv;charset=utf-8;');
}

// 使用示例:
const headers = ['用户ID', '姓名', '身份证号', '入职日期', '备注'];
const dataList = [
  ['1001', '张三', '110101199003072345', '2023-01-15', '部门主管, 负责华北区'],
  ['1002', '李四', '310104199508126789', '2023-04-20', '工作地点:"上海总部"']
];
// exportToCSV(headers, dataList, '员工清单.csv');

四、方案二:HTML Table 伪装法(支持单元格合并与排版)

如果业务方要求表头有背景色、文字加粗居中、或者存在跨行(rowspan)跨列(colspan)的复杂表头,纯 CSV 显然无法满足。此时可以使用“HTML 表格伪装法”。

该方案的原理是将完整的 HTML <table> 结构作为内容,将 MIME 类型设置为 application/vnd.ms-excel,并将下载后缀命名为 .xls。Excel 打开该文件时,会解析其中的内联 CSS 样式。

利用 mso-number-format 锁定文本格式

在 HTML 表格中,为了防止手机号、身份证号或订单流水号转为科学计数法,微软提供了一套特有的 CSS 属性:给对应单元格添加样式 style="mso-number-format:'\@';",Excel 就会将其强制视作文本,完美保全原本内容。

/**
 * 通过 HTML Table 伪装导出带样式的 Excel (.xls)
 * @param {string} tableHtml 包含完整 table 结构的 HTML 字符串
 * @param {string} filename 导出文件名
 */
function exportHtmlTableToExcel(tableHtml, filename = 'report.xls') {
  // 拼接带有 Excel 专有样式声明的完整 HTML 模板
  const template = `
    <html xmlns:o="urn:schemas-microsoft-com:office:office"
          xmlns:x="urn:schemas-microsoft-com:office:excel"
          xmlns="http://www.w3.org/TR/REC-html40">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <!--[if gte mso 9]>
      <xml>
        <x:ExcelWorkbook>
          <x:ExcelWorksheets>
            <x:ExcelWorksheet>
              <x:Name>工作表1</x:Name>
              <x:WorksheetOptions>
                <x:DisplayGridlines/>
              </x:WorksheetOptions>
            </x:ExcelWorksheet>
          </x:ExcelWorksheets>
        </x:ExcelWorkbook>
      </xml>
      <![endif]-->
      <style>
        table { border-collapse: collapse; width: 100%; }
        th { background-color: #17324D; color: #FFFFFF; font-weight: bold; border: 1px solid #D9E2EC; height: 32px; text-align: center; }
        td { border: 1px solid #D9E2EC; padding: 6px 10px; height: 26px; }
        /* 关键:强制声明为文本模式,防止长数字变形 */
        .text-cell { mso-number-format: "\@"; }
        .center { text-align: center; }
        .money { mso-number-format: "#,##0.00"; text-align: right; }
      </style>
    </head>
    <body>
      ${tableHtml}
    </body>
    </html>
  `;

  downloadBlobFile(template, filename, 'application/vnd.ms-excel;charset=utf-8');
}

// 快速生成示例
const demoTableHtml = `
  <table>
    <tr>
      <th colspan="4">2024年度销售业绩汇总表</th>
    </tr>
    <tr>
      <th>订单编号</th>
      <th>客户姓名</th>
      <th>销售金额</th>
      <th>状态</th>
    </tr>
    <tr>
      <td class="text-cell center">ORD202409010009871</td>
      <td class="center">王五</td>
      <td class="money">12580.50</td>
      <td class="center" style="color: #659B9B; font-weight: bold;">已付款</td>
    </tr>
  </table>
`;
// exportHtmlTableToExcel(demoTableHtml, '销售汇总.xls');

五、方案三:XML Spreadsheet 2003 格式(原生支持多 Sheet)

如果业务不仅需要样式,还必须在同一个 Excel 工作簿内包含多个 Sheet(多工作表),且依然要求纯前端零依赖,那么微软标准的 XML Spreadsheet 2003(SpreadsheetML) 是终极解法。

该规范以清晰的 XML 树形结构组织文档:<Workbook> 下容纳多个 <Worksheet ss:Name="Sheet名称">,每个 Sheet 内部包含 <Table>、<Row>、<Cell> 以及带具体类型的 <Data ss:Type="String|Number">。因为它是严格的字符流,前端直接拼装后即可导出为标准的 .xls 或 .xml 文件。

/**
 * 导出多工作表 (Multi-Sheet) Excel 文件
 * @param {Array<{sheetName: string, headers: string[], rows: any[][]}>} sheets 数据集
 * @param {string} filename 保存文件名
 */
function exportMultiSheetXml(sheets, filename = 'multi-sheet.xls') {
  let xml = `<?xml version="1.0" encoding="UTF-8"?>
<?mso-application progid="Excel.Sheet"?>
<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:o="urn:schemas-microsoft-com:office:office"
          xmlns:x="urn:schemas-microsoft-com:office:excel"
          xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:html="http://www.w3.org/TR/REC-html40">
  <Styles>
    <Style ss:ID="Default" ss:Name="Normal">
      <Alignment ss:Vertical="Center"/>
      <Font ss:FontName="PingFang SC" ss:Size="11" ss:Color="#17324D"/>
    </Style>
    <Style ss:ID="HeaderStyle">
      <Font ss:FontName="PingFang SC" ss:Size="12" ss:Bold="1" ss:Color="#FFFFFF"/>
      <Interior ss:Color="#17324D" ss:Pattern="Solid"/>
      <Alignment ss:Horizontal="Center" ss:Vertical="Center"/>
    </Style>
  </Styles>`;

  sheets.forEach(sheet => {
    xml += `\n  <Worksheet ss:Name="${sheet.sheetName}">\n    <Table>`;

    // 渲染表头
    xml += `\n      <Row ss:Height="24">`;
    sheet.headers.forEach(h => {
      xml += `<Cell ss:StyleID="HeaderStyle"><Data ss:Type="String">${h}</Data></Cell>`;
    });
    xml += `</Row>`;

    // 渲染每行数据
    sheet.rows.forEach(row => {
      xml += `\n      <Row ss:Height="20">`;
      row.forEach(val => {
        const isNum = typeof val === 'number' && !isNaN(val);
        const type = isNum ? 'Number' : 'String';
        xml += `<Cell><Data ss:Type="${type}">${val ?? ''}</Data></Cell>`;
      });
      xml += `</Row>`;
    });

    xml += `\n    </Table>\n  </Worksheet>`;
  });

  xml += `\n</Workbook>`;

  downloadBlobFile(xml, filename, 'application/vnd.ms-excel;charset=utf-8');
}

// 使用示例:同时导出“华北分部”与“华南分部”两个独立 Sheet
const testSheets = [
  {
    sheetName: '华北分部',
    headers: ['工号', '姓名', '当月销售额'],
    rows: [['HB01', '赵六', 84000], ['HB02', '钱七', 91500]]
  },
  {
    sheetName: '华南分部',
    headers: ['工号', '姓名', '当月销售额'],
    rows: [['HN01', '孙八', 102000], ['HN02', '周九', 78900]]
  }
];
// exportMultiSheetXml(testSheets, '全国各区业绩报表.xls');

六、三种免库导出方案选型对比

在不引入外部库的前提下,三种导出方案各有利弊。为了帮助你在实际项目中做出合理的架构决策,以下从多工作表、排版能力、数据精度保护、提示弹窗和体积开销等核心维度进行横向对比:

不依赖第三方库,JS怎么用Blob导出Excel
图 3:三种原生免库导出方案的多维特性对比矩阵
方案类型 典型优点 主要局限 推荐使用场景
方案一:CSV 纯文本 生成极快、内存开销最小,无打开格式警告弹窗 不支持单元格背景色、边框、合并与多 Sheet 纯数据清单导出、大批量日志或流水记录(万行以上)
方案二:HTML Table 伪装 直接沿用现有 HTML/CSS,支持单元格合并与基本排版 仅支持单 Sheet;双击打开时 Excel 可能会弹安全警告框 带多级表头、汇总底色、文字居中对齐的单页报表
方案三:XML 2003 标准 原生支持多 Sheet,强类型声明,无需任何外部依赖 XML 标签较繁复,维护模板稍繁琐 必须将不同分组数据输出在不同 Sheet 标签页中的复杂报表

七、核心排坑指南与生产环境注意事项

在将免库导出逻辑推向生产环境时,有几个非常具体且高频遇到的边界问题,务必做好前置防御:

不依赖第三方库,JS怎么用Blob导出Excel
图 4:导出过程中的典型问题排查与防御对策

1. 格式警告弹窗:“您尝试打开的文件格式与扩展名指定的格式不一致”

当使用方案二(HTML Table)或方案三(XML 2003)并将文件扩展名命名为 .xls 时,用户在部分较高版本的 Microsoft Office Excel 中双击打开时,系统可能会弹出一个对话框:“您尝试打开的文件 'xxx.xls' 的格式与文件扩展名指定的格式不一致。打开文件前请验证文件没有损坏且来自可信的来源。是否立即打开此文件?”

原因解释: Excel 的安全检查机制检测到文件的扩展名是 .xls(原为微软 BIFF 二进制格式),但内部实际是 HTML 标记语言或 XML 文本流。点击“是”即可正常展示全部内容与样式,完全不影响使用。如果业务场景对该弹窗非常敏感,建议首选 方案一(CSV 格式),CSV 采用纯正的扩展名与内容规范,完全不会出现此类提示。

2. 内存与数据量瓶颈(V8 引擎限制)

虽然 Blob 本身可以容纳数百 MB 的内容,但前端生成字符串这一步是受 JavaScript 堆内存(V8 Heap Limit)限制的。如果导出的数据行数超过 10 万行,一次性通过 join('') 拼接巨量字符串可能导致浏览器标签页卡顿甚至崩溃。对于超过 10 万行的大文件需求,推荐方案是:

  • 切片分块构造:将数据分批转为 BlobPart 数组,最后一次性 new Blob(chunkArray),避免单一巨大字符串常驻内存。
  • 或者将导出操作交由后端服务处理,前端仅发起下载请求。

3. 移动端 WebView 与 iOS Safari 兼容性

在部分移动端 App 内置的 WebView(如微信、钉钉客户端)中,出于安全考虑,往往会拦截虚拟 <a download> 标签的点击事件,导致下载无响应。在这种环境下,可以引导用户在系统默认浏览器(如 Safari 或 Chrome)中打开页面,或者在检测到受限环境时,使用 window.open(objectUrl, '_blank') 在新窗口尝试渲染。

八、总结与最佳实践

在现代 Web 开发中,不依赖第三方库导出 Excel 并非遥不可及的高深技巧。通过深入理解 Excel 的底层兼容机制与浏览器内置的 Blob、URL.createObjectURL API,我们可以用几行极简、透明的代码打造出 0 依赖、秒级响应的导出功能:

  • 数据量大、结构扁平:优先选择带 UTF-8 BOM(\uFEFF)的 CSV 方案,长数字追加制表符 \t 防截断;
  • 需要样式与合并表头:优先选择 HTML Table 伪装方案,结合 mso-number-format 控制格式;
  • 多工作表(Sheet)需求:采用 XML Spreadsheet 2003 规范构建纯文本标记流;
  • 下载生命周期管理:切记使用异步延时释放 URL.revokeObjectURL,确保客户端内存清洁无泄漏。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章