c++ 文件压缩和解压方法 c++如何使用zlib进行压缩

风静君_3959

风静君_3959

2026-03-21

740人浏览

原创

zlib的compress/uncompress适用于小内存同步压缩,需注意缓冲区大小和长度参数初始化;大文件应改用deflate/inflate流式处理,并正确设置window bits以匹配解压端格式。

c++ 文件压缩和解压方法 c++如何使用zlib进行压缩

zlib 的 compress 和 uncompress 函数怎么用,压缩率低或崩溃怎么办

这两个函数是 zlib 最轻量的接口,适合小块内存(比如几 KB 到几 MB)的同步压缩/解压。它们不处理文件 I/O,只操作内存,所以你得自己读文件到 std::vector<unsigned char></unsigned> 或 std::string 里再传进去。

常见错误是传错长度:比如把 uncompress 的输出缓冲区大小设得太小,导致返回 Z_BUF_ERROR;或者没初始化输出长度变量(它是个指针参数,必须提前赋值为缓冲区容量)。

  • compress 输入长度不能为 0,否则返回 Z_STREAM_ERROR
  • 输出缓冲区大小建议设为 input_size + 12(zlib 最坏情况会多几个字节头),但更稳妥是先调一次 compressBound(input_size) 获取上限
  • uncompress 前必须把 *destLen 设成目标缓冲区总大小,不是 0 —— 它会覆写这个值为实际解压后长度

示例片段:

std::vector<unsigned char> src = read_file("data.bin");
std::vector<unsigned char> dst(compressBound(src.size()));
uLong dst_len = dst.size();
int ret = compress(dst.data(), &dst_len, src.data(), src.size());
if (ret != Z_OK) { /* 处理错误 */ }</unsigned></unsigned>

用 deflate / inflate 手动流式压缩文件,避免内存爆炸

直接用 compress 处理几百 MB 的文件会把整个文件读进内存,然后输出缓冲区也可能翻倍——这是最常被忽略的坑。真实场景该用流式 API,边读边压,边写边存。

核心是维护一个 z_stream 结构体,调 deflateInit 初始化,循环调 deflate,每次喂一部分输入、取一部分输出。解压同理。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 输入缓冲区(next_in)和输出缓冲区(next_out)可以很小,比如 4KB~64KB,不依赖文件大小
  • 务必检查 deflate 返回值:Z_OK 表示继续,Z_STREAM_END 表示完成,Z_BUF_ERROR 通常意味着输出缓冲区满了,要先写出去再继续
  • 不要在循环里反复 new/delete 缓冲区;复用同一块内存,只更新 avail_in 和 avail_out

注意:deflate 默认不加 zlib 头(RFC 1950),如果后续要用 Python 的 zlib.decompress(),就得用 deflateInit2(&strm, level, Z_DEFLATED, -15, ...) 把 window bits 设为 -15 来禁用头——否则 Python 会报 OSError: Error -3 while decompressing data。

Windows 下链接 zlib 失败:找不到 inflate 或 deflate

典型错误是链接时提示 LNK2019: unresolved external symbol inflate,尤其在 VS 里静态链接 zlibstatic.lib 时容易出。根本原因不是函数不存在,而是 C++ 名称修饰(name mangling)让链接器找不到 C 函数。

  • 必须在包含 <zlib.h></zlib.h> 前加 extern "C" 块,或者确保头文件本身已做了 C 链接声明(官方 zlib.h 有,但某些第三方打包版可能漏了)
  • 确认你链接的是对应架构的库:x64 项目不能链 x86 的 zlib.lib,反之亦然
  • VS 中若用预编译头,#include <zlib.h></zlib.h> 必须放在 stdafx.h 之后,否则宏定义(如 ZLIB_WINAPI)可能失效
  • MinGW 用户注意:默认链接的是 libz.dll.a,运行时要确保 zlib1.dll 在 PATH 或可执行目录下

压缩后文件打不开?检查 gz、zlib、raw deflate 格式区别

zlib 库本身不生成 .gz 文件——那是 gzip 格式,带额外 header 和 CRC。如果你用 deflate 输出的数据想用 gunzip 解,大概率失败。

  • deflate(无头):window bits = -15,Python 用 zlib.decompress(data, -15)
  • zlib 格式(默认):window bits = 15,Python 直接 zlib.decompress(data)
  • gzip 格式:必须用 gzopen/gzwrite 系列函数,或自己拼 header + CRC + ADLER32 —— 不推荐手写

最容易踩的坑是:用 deflate 压完数据,存成 .gz 后缀,然后双击用系统解压工具打开——它认的是 gzip 格式,不是 raw deflate,必然报错“未知格式”或“CRC 校验失败”。后缀只是个标记,内容格式才是关键。

复杂点在于:不同语言对“zlib 自动检测格式”的支持程度不同。比如 Node.js 的 zlib.unzip() 能自动识别 gzip/zlib/raw,但 C++ 侧必须明确指定 window bits。一旦格式和解压方式不匹配,就只能看到一串乱码或崩溃。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6179

3

while的用法
while的用法

while的用法是“while 条件: 代码块”,条件是一个表达式,当条件为真时,执行代码块,然后再次判断条件是否为真,如果为真则继续执行代码块,直到条件为假为止。本专题为大家提供while相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.25

354

5

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

969

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

2840

5

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

4594

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

4751

25

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

2026.04.23

359

31

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3128

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4809

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习