zlib的compress/uncompress适用于小内存同步压缩，需注意缓冲区大小和长度参数初始化；大文件应改用deflate/inflate流式处理，并正确设置window bits以匹配解压端格式。
zlib 的 compress 和 uncompress 函数怎么用，压缩率低或崩溃怎么办
这两个函数是 zlib 最轻量的接口，适合小块内存（比如几 KB 到几 MB）的同步压缩/解压。它们不处理文件 I/O，只操作内存，所以你得自己读文件到 std::vector<unsigned char> 或 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) { /* 处理错误 */ }用 deflate / inflate 手动流式压缩文件，避免内存爆炸
直接用 compress 处理几百 MB 的文件会把整个文件读进内存，然后输出缓冲区也可能翻倍——这是最常被忽略的坑。真实场景该用流式 API，边读边压，边写边存。
立即学习“C++免费学习笔记（深入）”；
核心是维护一个 z_stream 结构体，调 deflateInit 初始化，循环调 deflate，每次喂一部分输入、取一部分输出。解压同理。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 输入缓冲区（
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>前加extern "C"块，或者确保头文件本身已做了 C 链接声明（官方 zlib.h 有，但某些第三方打包版可能漏了） - 确认你链接的是对应架构的库：x64 项目不能链 x86 的
zlib.lib，反之亦然 - VS 中若用预编译头，
#include <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。一旦格式和解压方式不匹配，就只能看到一串乱码或崩溃。
