Node.js 流式归档 vs 浏览器内存压缩：Archiver、JSZip 与 PizZip 深度对比

在 JavaScript 生态中处理 ZIP 压缩文件时，开发者常面临三个主要选择：archiver、jszip 和 pizzip。虽然它们都能生成 ZIP 文件，但底层机制、运行环境和适用场景差异巨大。选错工具可能导致浏览器崩溃、服务器内存溢出或代码难以维护。让我们从架构师的角度深入对比。

🖥️ 运行环境：服务器专属 vs 全平台通用

archiver 是纯粹的 Node.js 库。

• 它依赖 Node.js 的 stream 模块。
• 无法直接在浏览器中运行，不适合前端打包任务。

// archiver: 仅适用于 Node.js
const archiver = require('archiver');
const output = fs.createWriteStream('archive.zip');
const archive = archiver('zip');

archive.pipe(output);
archive.append(fs.createReadStream('file.txt'), { name: 'file.txt' });
archive.finalize();

jszip 是跨平台的。

• 可以在浏览器、Node.js、Web Worker 中运行。
• 依赖 polyfill 处理旧环境，但现代环境无需配置。

// jszip: 浏览器或 Node.js 均可
const JSZip = require('jszip');
const zip = new JSZip();

zip.file('file.txt', 'Hello World');
zip.generateAsync({ type: 'blob' }).then(function(content) {
    // 在浏览器中可触发下载
    saveAs(content, 'archive.zip');
});

pizzip 同样支持全平台。

• 设计初衷是为了配合文档生成库。
• 在浏览器中表现良好，但社区活跃度低于 jszip。

// pizzip: 浏览器或 Node.js 均可
const PizZip = require('pizzip');
const zip = new PizZip();

zip.file('file.txt', 'Hello World');
// 生成同步或异步取决于配置，通常用于文档二进制流
const content = zip.generate({ type: 'blob' });

🚰 数据处理模式：流式管道 vs 内存加载

这是三者最核心的架构差异，直接影响性能上限。

archiver 使用流式处理（Streaming）。

• 数据分块处理，不一次性加载到内存。
• 适合 GB 级别的文件归档，内存占用恒定。

// archiver: 流式管道，内存友好
const archive = archiver('zip', { zlib: { level: 9 } });

// 直接管道到 HTTP 响应，无需等待全部完成
archive.pipe(res);

// 可以持续添加文件流
archive.append(fs.createReadStream('large-file.log'), { name: 'log.txt' });
archive.finalize();

jszip 使用内存加载（In-Memory）。

• 所有文件内容必须先加载到内存中才能生成 ZIP。
• 处理大文件时容易导致浏览器标签页崩溃或 Node 进程 OOM。

// jszip: 全量内存加载
const zip = new JSZip();

// 文件内容必须完全读取
zip.file('large-file.log', fs.readFileSync('large-file.log'));

// generateAsync 会阻塞直到所有数据压缩完成
const content = await zip.generateAsync({ type: 'nodebuffer' });

pizzip 同样基于内存加载。

• 机制与 jszip 类似，不适合超大文件。
• 优势在于对二进制文档结构的兼容性。

// pizzip: 全量内存加载
const zip = new PizZip();

zip.file('document.xml', binaryContent);

// generate 通常返回完整内容
const content = zip.generate({ type: 'base64' });

⚡ API 设计与异步控制

archiver 基于事件和流。

• 使用 .pipe() 连接目标，通过事件监听进度。
• 需要理解 Node.js 流背压（backpressure）机制。

// archiver: 事件驱动
archive.on('progress', function(data) {
    console.log('Progress:', data.entries.processed);
});

archive.on('error', function(err) {
    throw err;
});

jszip 基于 Promise。

• API 现代，易于与 async/await 结合。
• generateAsync 明确表明异步操作。

// jszip: Promise 链
try {
    const content = await zip.generateAsync({ 
        type: 'blob',
        compression: 'DEFLATE',
        compressionOptions: { level: 9 }
    });
    console.log('Zip generated');
} catch (err) {
    console.error('Generation failed', err);
}

pizzip 混合风格。

• 主要 API 是同步的 generate()，但也支持回调。
• 在复杂异步流程中可能需要额外封装。

// pizzip: 同步或回调
const content = zip.generate({ 
    type: 'blob',
    compression: 'DEFLATE'
});
// 或者
zip.generate(function(err, data) {
    if (err) throw err;
    console.log('Done');
});

📄 特定场景：Office 文档生成

这是 pizzip 存在的核心理由。

archiver 不特定于文档。

• 通用归档，不适合直接操作 docx 内部结构。

// archiver: 通用文件打包
archive.directory('./docs/', 'documents');

jszip 可用于文档，但需手动处理。

• 可以解压 docx，修改 XML，再压缩。
• 但 docxtemplater 官方推荐 pizzip。

// jszip: 手动处理 docx 结构
const zip = await JSZip.loadAsync(file);
const content = await zip.file('document.xml').async('string');
// 需要手动管理 XML 命名空间和结构

pizzip 与 docxtemplater 深度集成。

• 专门优化了 Office 文档的二进制兼容性。
• 减少生成损坏文档的风险。

// pizzip: 配合 docxtemplater
const zip = new PizZip(content);
const doc = new docxtemplater(zip, { paragraphLoop: true, linebreaks: true });
doc.render({ user: 'John' });
const out = doc.getZip().generate({ type: 'blob' });

📊 核心差异总结

💡 架构师建议

archiver 是后端服务的标准选择 🖥️。当你需要在 Node.js 服务器上打包日志、备份数据库 dump 文件或提供大文件下载时，它是唯一正确的选择。流式架构保证了服务器的稳定性。

jszip 是前端开发的首选工具 🌐。如果你需要在浏览器中让用户下载多个文件、导出项目数据或处理中小型压缩包，它的 Promise API 和广泛的文档支持能极大提高开发效率。

pizzip 是特定领域的专用工具 📑。除非你正在使用 docxtemplater 生成 Word/PPT 报告，否则优先选择 jszip。在通用 ZIP 处理上，jszip 的社区支持和更新频率更具优势。

最终思考：不要试图在浏览器中使用 archiver（无法运行），也不要试图在服务器上用 jszip 处理 GB 级文件（会崩溃）。根据数据流向和运行环境做出选择，是架构设计的基本功。