最常见原因是输出缓冲区太小；zlib的compress不自动分配内存，必须手动预估并分配足够空间，推荐用compressbound(srclen)计算最小安全大小，避免栈上小数组溢出，调用后destlen被写入实际压缩字节数且一定≤缓冲区长度。
zlib压缩字符串时，compress函数为什么返回Z_BUF_ERROR
最常见原因是输出缓冲区太小。zlib的compress不自动分配内存，必须手动预估并分配足够空间——经验公式是输入长度 + 12 字节（zlib头尾开销），但保险起见建议按 input_size + input_size / 1000 + 12 分配。
实操建议：
- 先用
compressBound计算最小安全大小：uLong destLen = compressBound(srcLen)，这是最可靠方式 - 不要传栈上小数组（如
char buf[64]）给compress，容易溢出 -
compress成功后，destLen会被写入实际压缩后字节数，这个值一定 ≤ 你传入的缓冲区长度
如何正确调用compress完成一次完整压缩
核心是三步：申请输出缓冲 → 调用compress → 检查返回值。它不抛异常，只靠返回码判断结果。
示例代码关键片段：
std::string input = "hello world";
std::vector<unsigned char> output(compressBound(input.size()));
uLong outLen = output.size(); // 注意：传入的是容量，不是当前size
int ret = compress(output.data(), &outLen,
reinterpret_cast<const unsigned char>(input.data()),
input.size());
if (ret != Z_OK) {
// 处理错误，比如 Z_MEM_ERROR 或 Z_BUF_ERROR
}
output.resize(outLen); // 真实压缩长度
</const></unsigned>
注意点：
-
output必须是std::vector<unsigned char></unsigned>或unsigned char*，不能用std::string直接接二进制数据（可能含\0） -
outLen是输入输出参数，调用前要设为缓冲区总长，调用后被改写为实际写入字节数 - 输入指针必须是
const unsigned char*，std::string::data()在C++11后保证连续且可转，但需reinterpret_cast
解压时uncompress失败，常见原因是什么
90%以上是因为没传对destLen——它必须是原始未压缩数据的**确切长度**，而不是缓冲区大小。zlib不会猜原始长度。
所以压缩时必须把原始长度一起保存下来（通常前置4字节存uint32_t）：
- 压缩后，把
input.size()和压缩数据一起序列化，比如std::vector<uint8_t> packed = {len_bytes..., compressed_data...}</uint8_t> - 解压前，先读出原始长度
origLen，再分配std::vector<unsigned char>(origLen)</unsigned>作为输出缓冲 - 调用
uncompress(dest, &origLen, src, srcLen)，此时origLen既是输入（期望长度）也是输出（实际解出长度）
如果原始长度错了，uncompress会直接返回Z_DATA_ERROR，不是内存越界——这点容易误判。
C++里要不要用z_stream做流式压缩
单次短字符串（compress/uncompress更简单、不易出错；只有需要增量压缩（比如边读文件边压）、内存受限（不想一次性加载全部数据）、或要控制压缩级别时，才值得上deflate/inflate流接口。
流式接口复杂点在于：
- 要手动管理
z_stream结构体生命周期（deflateInit2/deflateEnd） - 每次调用需设置
next_in、avail_in、next_out、avail_out，还要处理Z_OK/Z_STREAM_END等多状态返回 - 压缩级别通过
level参数传（Z_DEFAULT_COMPRESSION或1~9），而compress固定用Z_DEFAULT_COMPRESSION
除非业务明确要求分块处理或定制压缩率，否则别过早优化。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
