应使用inflateInit2(&strm, 16 + MAX_WBITS)配合inflate解压内存中.gz数据，window bits必须设为16+MAX_WBITS以识别gzip头，否则返回Z_DATA_ERROR或解压失败；务必检查strm.msg定位错误原因。
zlib 解压内存中的 .gz 数据：用 inflate 而不是 gzread
直接在内存里解压 .gz 文件，不能用 gzopen/gzread —— 它们只认文件路径或 FILE*，不接受内存 buffer。真正该用的是 zlib 底层 inflate 流接口：inflateInit2 + inflate，配合 ZLIB_WINDOW_BITS 设为 16+MAX_WBITS 才能识别 gzip 头。
常见错误现象：inflate 返回 Z_DATA_ERROR，或者解出来全是乱码、前几个字节就失败 —— 基本都是 window bits 没设对，误用了默认的 MAX_WBITS（只支持 raw deflate）。
-
inflateInit2(&strm, 16 + MAX_WBITS)是硬性要求，少写16+就无法识别 gzip header - 输入 buffer 必须包含完整 .gz 字节流（从
1f 8b开始），不能截断、不能带额外头尾 - 输出 buffer 大小得预估或动态扩容；zlib 不自动分配内存，
strm.avail_out == 0时必须扩大strm.next_out并重置avail_out
手动管理 z_stream：别漏掉 inflateEnd 和错误检查
zlib 的 C API 是纯状态机，所有资源都靠手动管理。忘了调 inflateEnd 会泄漏内部分配的 window 内存；没检查 inflate 返回值可能把部分失败当成功处理。
典型使用场景：加载网络返回的 gzip 响应体、读取嵌入资源段、解析打包格式里的压缩块。
- 每次调
inflate后必须检查返回值：Z_OK（继续）、Z_STREAM_END（完成）、Z_BUF_ERROR（输出不够）、Z_DATA_ERROR（输入损坏或格式不对） -
inflateEnd必须在所有inflate调用结束后调用，哪怕中间出错也要调，否则下次 init 可能失败 - 不要复用未
inflateEnd的z_stream结构体，C++ 中建议用 RAII 包一层（但底层逻辑不变）
C++ 封装要点：避免 std::vector::data() 生命周期陷阱
用 std::vector 存压缩数据很常见，但直接传 vec.data() 给 z_stream 时，容易忽略 vector realloc 导致指针失效。更隐蔽的问题是：解压目标 buffer 如果也用 vector，resize() 后 data() 地址可能变，而 z_stream.next_out 还指着旧地址。
性能影响：频繁 resize 输出 buffer 会触发多次 memcpy；兼容性上，zlib 本身无 C++ 依赖，但封装时要注意 ABI 稳定性（比如别把 z_stream 成员塞进 class private 区而不加 static_assert 校验大小）。
- 输入 buffer 推荐用
const uint8_t*+size_t显式传入，不绑定容器生命周期 - 输出 buffer 用
std::vector时，先reserve()预估大小（如原始大小 × 1.5），再用&vec[0]或vec.data()赋给next_out，每次inflate前确认指针仍有效 - 如果原始大小完全未知，宁可多分配几次 buffer（比如每次翻倍），也不要让
avail_out == 0卡死流程
gzip header 检查和错误定位：别跳过 z_stream.msg
遇到 Z_DATA_ERROR，第一反应不该是重试或换库，而是看 strm.msg —— 它是 zlib 唯一能告诉你“为什么错”的字段，比如 "invalid distance too far back" 表示数据损坏，"incorrect header check" 表示 magic 不对或被截断。
容易被忽略的地方：有些 .gz 文件开头有 2 字节额外 header（比如某些打包工具 prepend 的校验信息），或者末尾混入了多余字节，都会导致 msg 报 header 相关错误。
- 用十六进制查看前 4 字节是否为
1f 8b 08 00（标准 gzip header），如果不是，要么不是 gzip，要么被污染 - 解压前用
memcmp(buf, "\x1f\x8b", 2)快速过滤，避免把其他格式丢给inflate -
strm.msg是 const char*，内容仅在最近一次 inflate 调用后有效，要立刻保存或打印，不能延迟访问
事情说清了就结束。最常卡住的点就两个：window bits 忘加 16，以及 strm.msg 没看。其他都是围绕这两条展开的细节。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
