基于 JSZip 的批量下载文件打包方案

在 Web 开发中，批量下载数据是高频需求。传统逐个文件下载的方式不仅效率低下，还会造成浏览器卡顿（Chrome 最多允许同时下载 6 个文件）。本文将详细介绍开源库 JSZip 的核心特性与实战技巧，结合代码示例分析其优劣势。

JSZip官方传送门：https://stuk.github.io/jszip/

---

一、技术选型背景

典型场景：电商后台管理系统导出订单数据时，用户可选择：

1. 单个 CSV 文件下载
2. 多个 CSV 文件打包下载
3. 支持 ZIP/TAR 格式选择

传统实现方案缺陷：

• 服务端 ZIP：增加服务器压力，延迟明显
• 浏览器原生 API：Blob 只能生成单个文件
• 第三方插件兼容性问题

---

二、JSZip 核心特性

1. 文件格式支持矩阵

支持类型	说明
ZIP	主流压缩格式
TAR	Unix 系统常用归档
IMG	Base64 图片转换
CSV	自动表格序列化

2. 异步流式处理

const zip = new JSZip();
zip.file("data.csv", csvContent, { base64: true });
zip.generateAsync({ type: "blob" }).then((blob) => saveAs(blob, "report.zip"));

3. 文件树结构构建

// 创建三级目录结构
zip.folder("2024").folder("Q1").file("sales.txt", "季度销售数据");

---

三、实战案例：表格数据打包下载

1. HTML 结构

<table id="data-table">
  <thead>
    <tr>
      <th>订单号</th>
      <th>客户名称</th>
    </tr>
  </thead>
  <tbody>
    <!-- 动态生成的表格行 -->
  </tbody>
</table>

<button id="download-btn">批量下载</button>

2. 核心逻辑实现

// 表格转 CSV 函数
function tableToCsv(table) {
  const rows = [];
  const headers = Array.from(table.querySelectorAll("th")).map(
    (el) => el.textContent
  );
  rows.push(headers.join(","));

  table.querySelectorAll("tbody tr").forEach((row) => {
    const cells = Array.from(row.querySelectorAll("td")).map((el) =>
      el.textContent.replace(/,/g, "'")
    );
    rows.push(cells.join(","));
  });
  return rows.join("\n");
}

// 主逻辑
document.getElementById("download-btn").addEventListener("click", () => {
  const csvContent = tableToCsv(document.getElementById("data-table"));

  const zip = new JSZip();
  zip.file("orders.csv", csvContent, { mimeType: "text/csv" });

  // 添加图片附件示例
  fetch("/api/logo.png")
    .then((res) => res.blob())
    .then((blob) => zip.file("logo.png", blob));

  zip
    .generateAsync({ type: "blob" })
    .then((blob) => saveAs(blob, "report.zip"))
    .catch((error) => console.error("打包失败:", error));
});

---

四、性能优化策略

1. 分片压缩技术

// 大文件分片处理（需结合 Web Worker）
function createLargeFile(zip, fileName, chunkSize) {
  const totalChunks = Math.ceil(largeData.length / chunkSize);
  let currentChunk = 0;

  function appendChunk() {
    const chunk = largeData.slice(currentChunk * chunkSize, (currentChunk+1)*chunkSize);
    zip.file(`${fileName} (${currentChunk+1}).part`, chunk, { base64: true });
    currentChunk++;

    if (currentChunk < totalChunks) {
      setTimeout(appendChunk, 100); // 模拟异步加载
    } else {
      zip.generateAsync(...); // 生成完整文件
    }
  }

  appendChunk();
}

2. 进度提示优化

zip.on("fileadd", (fileName, file) => {
  updateProgressBar((currentFileCount / totalFiles) * 100);
});

zip.on("generate", (metadata) => {
  console.log(`生成进度: ${metadata.percent.toFixed(1)}%`);
});

---

五、优缺点深度剖析

▶️ 核心优势

1. 跨平台兼容性：支持主流浏览器（Chrome 58+ / Firefox 53+ / Edge 16+）
2. 无服务端依赖：全部操作在客户端完成
3. 格式扩展性强：支持自定义 MIME 类型
4. 内存管理优化：采用流式处理避免内存溢出

⚠️ 潜在缺陷

1. 压缩效率限制：纯前端压缩比服务端低约 30%-50%
2. 文件大小限制：Chrome 最大支持 512MB（不同浏览器有差异）
3. 浏览器兼容陷阱：
   • IE11 需要 polyfill
   • Safari 不支持 Web Worker 加速
4. 安全风险：敏感数据需谨慎处理 Base64 编码

---

六、替代方案对比

方案	适用场景	优势	缺陷
JSZip	小规模数据打包	完全前端控制	大文件性能差
后端 ZIP 生成	超过 10MB 数据	压缩效率高	增加服务器负载
浏览器原生 API	单文件下载	无需额外库	不支持多文件打包

---

七、最佳实践建议

1. 性能监控：使用 performance API 记录打包耗时

const startTime = performance.now();
zip.generateAsync(...).then(() => {
  console.log(`打包耗时: ${performance.now() - startTime.toFixed(2)}ms`);
});

2. 错误处理机制

zip.on("error", (err) => {
  alert(`打包失败: ${err.message}`);
  // 可尝试降级方案：分批次下载
});

3. 用户体验优化

• 显示进度条（建议使用 ProgressBar.js）
• 支持暂停/继续功能（需结合 Web Worker）
• 提供格式选择下拉菜单

---

通过合理运用 JSZip，我们可以在不增加服务器负担的前提下，为用户提供流畅的批量下载体验。对于超大规模数据（建议 >50MB），推荐采用「前端分片 + 后端合并」混合架构方案。后续文章将深入探讨该混合模式的实现细节。