直接用z_stream解压内存数据可行但需手动管理缓冲区、调用循环和状态检查；必须清零结构体、正确设置windowBits、循环调用inflate()直至Z_STREAM_END、动态扩容输出缓冲区、最后调用inflateEnd()。
直接用 z_stream 解压内存中的压缩数据是可行的，但必须手动管理输入/输出缓冲区、调用顺序和状态检查——它不是“传入指针就返回解压结果”的封装函数，漏掉任意一步都会导致崩溃或静默失败。
初始化 z_stream 时必须显式清零并调用 inflateInit2()
z_stream 是 zlib 的核心结构体，未初始化的字段（尤其是 zalloc/zfree/opaque）若为随机值，inflateInit2() 可能直接 abort。不能只靠 memset(&strm, 0, sizeof(strm)) 就认为安全——还要确认 zlib 版本兼容性。
- 务必用
memset(&strm, 0, sizeof(z_stream))清零整个结构体 - 调用
inflateInit2(&strm, windowBits)，其中windowBits需匹配压缩格式：15 表示标准 zlib，-15 表示 raw DEFLATE（无 header/tailer），8–15 均有效，但错配会导致Z_DATA_ERROR - 检查返回值是否为
Z_OK，否则后续所有调用都无效
inflate() 必须循环调用，且每次都要更新 next_in/avail_in 和 next_out/avail_out
内存解压不是单次操作。zlib 按内部块粒度处理数据，inflate() 返回 Z_OK 仅表示“还有更多输入可读”，不表示完成；返回 Z_STREAM_END 才是真正结束。常见错误是只调用一次就认为解压完了。
- 把压缩数据起始地址赋给
strm.next_in，长度赋给strm.avail_in - 分配足够大的输出缓冲区（如 4×输入大小），设
strm.next_out和strm.avail_out - 在
while (strm.avail_in > 0 || strm.avail_out == 0)循环中反复调用inflate() - 每次返回
Z_OK后，必须手动推进指针：strm.next_in += consumed; strm.avail_in -= consumed;（实际消耗量由strm.total_in - prev_total_in得到）
输出缓冲区不足时不能硬扩，而要重试或动态扩容
inflate() 遇到 strm.avail_out == 0 会返回 Z_OK 并暂停，此时必须提供新缓冲区空间再继续。强行增大 avail_out 而不更新 next_out 会导致越界写入。
- 检测
inflate()返回Z_BUF_ERROR或avail_out == 0且avail_in > 0，说明输出空间耗尽 - 把已解压部分拷贝到更大缓冲区，更新
strm.next_out指向新空间末尾，strm.avail_out设为剩余容量 - 切勿复用原
next_out地址 + 增大avail_out，这等于告诉 zlib “后面内存可写”，极易触发段错误
清理必须调用 inflateEnd()，且不能重复调用
inflateEnd() 会释放 zlib 内部分配的内存（如滑动窗口）。忘记调用会导致内存泄漏；重复调用则可能 double-free。
- 只要
inflateInit2()成功返回Z_OK，无论后续inflate()是否成功，都必须调用inflateEnd() - 调用后立即把
strm.zalloc置为nullptr或加标记，避免二次调用 - 若在异常路径中提前退出（如抛异常），需确保
inflateEnd()在析构或catch块中执行
最易被忽略的是 windowBits 参数与压缩流格式的严格对应关系：gzip、zlib、raw DEFLATE 使用完全不同的头部解析逻辑，错配不会报错，而是返回 Z_DATA_ERROR 或解出乱码。调试时先用 zlib 自带的 zpipe 工具验证原始数据格式，再决定 inflateInit2() 的参数。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
