Node.js 怎么用 zlib 流式压缩和解压文件？

Question

仓乃文 · Accepted Answer

大文件压缩用 zlib.gzipSync 会把整个文件读入内存再压缩，1GB 文件需要 1GB+ 内存。zlib 的流式 API 配合 pipeline 边读边压边写，内存占用恒定，适合处理 GB 级文件。

流式压缩：
```javascript
const { pipeline } = require("stream");
const zlib = require("zlib");
const fs = require("fs");

pipeline(
  fs.createReadStream("access.log"),
  zlib.createGzip(),
  fs.createWriteStream("access.log.gz"),
  (err) => {
    if (err) console.error("压缩失败:", err);
    else console.log("压缩完成");
  }
);
```

流式解压：
```javascript
pipeline(
  fs.createReadStream("access.log.gz"),
  zlib.createGunzip(),
  fs.createWriteStream("access.log"),
  (err) => {
    if (err) console.error("解压失败:", err);
    else console.log("解压完成");
  }
);
```

控制压缩级别：
```javascript
const gzip = zlib.createGzip({ level: zlib.constants.Z_BEST_SPEED });
// Z_NO_COMPRESSION(0) ~ Z_BEST_COMPRESSION(9)
// Z_DEFAULT_COMPRESSION = -1（默认，约等于 6）
```

补充说明：
- createGzip/createGunzip 是流式 API，createDeflate/createInflate 用 deflate 格式
- 压缩级别越高压缩率越好但速度越慢，默认 -1 是速度和压缩率的平衡
- HTTP 响应压缩：res.pipe(zlib.createGzip()).pipe(res)
- Node.js 10+ 可以用 stream/promises 的 pipeline 配合 async/await
- 生产环境务必用 pipeline 而非 pipe，防止流错误导致内存泄漏