zip.js完全指南：浏览器端文件压缩解压利器

当前位置：点晴教程→知识管理交流 →『技术文档交流』

freeflydom

2026年3月10日 16:44 本文热度 46

zip.js是一个开源的JavaScript库，专门用于在浏览器、Deno和Node.js环境中压缩和解压ZIP文件。该库设计用于处理大量数据，支持多核压缩、压缩流、Zip64格式（超过4GB的压缩包）、分卷压缩文件和数据加密等高级功能。

核心特性

高性能压缩

多核并行压缩，充分利用现代CPU性能
支持原生压缩流，提升处理效率
Web Worker智能管理，避免阻塞主线程

安全加密

支持WinZIP AES加密（AES-128、AES-192、AES-256）
支持PKWare ZipCrypto加密
提供密码验证和数据保护机制

格式兼容

完整支持Zip64标准，突破4GB文件大小限制
兼容标准ZIP格式和分卷压缩文件
支持USDZ文件格式处理

快速开始

环境配置

通过npm安装最新版本：

npm install @zip.js/zip.js

或直接通过CDN引入：

<script src="https://unpkg.com/@zip.js/zip.js/index.js"></script>

基础使用示例

创建一个简单的ZIP文件：

import {
  BlobReader,
  BlobWriter,
  TextReader,
  TextWriter,
  ZipReader,
  ZipWriter,
} from "@zip.js/zip.js";
// 创建ZIP写入器
const zipFileWriter = new BlobWriter();
const helloWorldReader = new TextReader("Hello world!");
// 添加文件到压缩包
const zipWriter = new ZipWriter(zipFileWriter);
await zipWriter.add("hello.txt", helloWorldReader);
await zipWriter.close();
// 获取生成的ZIP文件
const zipFileBlob = await zipFileWriter.getData();

读取ZIP文件内容

// 创建ZIP读取器
const zipFileReader = new BlobReader(zipFileBlob);
const helloWorldWriter = new TextWriter();
// 读取第一个文件的内容
const zipReader = new ZipReader(zipFileReader);
const firstEntry = (await zipReader.getEntries()).shift();
const helloWorldText = await firstEntry.getData(helloWorldWriter);
await zipReader.close();
// 输出 "Hello world!"
console.log(helloWorldText);

高级功能

流式处理

使用TransformStream进行流式压缩和解压：

import { BlobReader, ZipReader, ZipWriter } from "@zip.js/zip.js";
// 创建流式压缩
const zipFileStream = new TransformStream();
const zipFileBlobPromise = new Response(zipFileStream.readable).blob();
const helloWorldReadable = new Blob(["Hello world!"]).stream();
const zipWriter = new ZipWriter(zipFileStream.writable);
await zipWriter.add("hello.txt", helloWorldReadable);
await zipWriter.close();
const zipFileBlob = await zipFileBlobPromise;

并发添加多个文件

import { BlobWriter, HttpReader, TextReader, ZipWriter } from "@zip.js/zip.js";
const README_URL = "https://unpkg.com/@zip.js/zip.js/README.md";
async function getZipFileBlob() {
  const zipWriter = new ZipWriter(new BlobWriter("application/zip"));
  await Promise.all([
    zipWriter.add("hello.txt", new TextReader("Hello world!")),
    zipWriter.add("README.md", new HttpReader(README_URL)),
  ]);
  return zipWriter.close();
}