zlib压缩文件前必须确认三件事：一是z_stream结构体需memset初始化为0，二是next_in和next_out必须指向有效内存地址而非nullptr，三是deflateinit返回z_ok后才能调用deflate，否则会崩溃或返回z_stream_error。
zlib压缩文件前必须确认的三件事
直接调用 deflate 会崩溃，不是代码写错了，而是 zlib 要求你手动管理内存和状态机。没初始化 z_stream、没调用 deflateInit、或者传了空指针进 deflate，都会触发 SIGSEGV 或返回 Z_STREAM_ERROR。
-
z_stream必须 memset 为 0，不能只声明不初始化 - 输入输出缓冲区（
next_in/next_out）必须是有效内存地址，不能为nullptr（哪怕暂时没数据） -
deflateInit返回非Z_OK时，不能继续调用deflate；常见原因是参数level超出 [-1,9] 范围（-1 表示 Z_DEFAULT_COMPRESSION）
读文件 → 压缩 → 写 .gz 文件的最小可行流程
zlib 本身不处理文件名或 .gz 格式封装，它只做 DEFLATE 压缩。要生成标准 .gz 文件，得自己写 gzip header + trailer，或者改用 gzopen/gzwrite —— 后者更简单且兼容性好。
- 用
gzopen("out.gz", "wb")替代fopen，它自动写魔数1f 8b和 gzip header - 用
gzwrite(zfile, buf, len)替代fwrite，内部已封装分块deflate调用 - 别忘了
gzclose(zfile)：它会自动 flush 剩余数据并写 CRC32 + ISIZE trailer
示例关键片段：
gzFile gz = gzopen("data.txt.gz", "wb");
if (!gz) { /* 处理打开失败 */ }
gzwrite(gz, data, size);
gzclose(gz); // 不调用这个，文件就损坏
手动调用 deflate 时 buffer 大小怎么设才不丢数据
压缩过程是流式的，输入数据可能被拆成多段处理，输出 buffer 不够大会导致 Z_BUF_ERROR，但不会丢失数据——只是要你换更大的 next_out 并重试。
- 输入 buffer（
next_in）大小任意，但建议 ≤64KB，避免单次调用耗时过长 - 输出 buffer（
next_out）至少预留compressBound(input_size)字节，这是 zlib 提供的上界估算函数 - 每次
deflate返回Z_OK表示还有更多输出可取；返回Z_STREAM_END才表示全部完成
错误写法：char out[1024]; 硬编码太小；正确做法：std::vector<uint8_t> out(compressBound(in_size));</uint8_t>
Windows 下链接 zlib 的常见报错和修复
VS 编译时报 LNK2019: unresolved external symbol _deflate，大概率是没链接 zlib 库，或用了不同编译模式的库版本。
- 确认你用的是
zlib.lib（不是zlibstatic.lib），且与项目配置一致：MD/MT、x86/x64、Debug/Release - MinGW 用户注意：默认安装的
libz.dll.a是动态链接导入库，运行时需确保zlib1.dll在 PATH 或同目录 - CMake 中推荐用
find_package(ZLIB REQUIRED)，然后target_link_libraries(myapp PRIVATE ZLIB::ZLIB)，比硬写-lz更可靠
一个容易忽略的点：zlib 的 C API 没有命名空间，C++ 项目里包含 <zlib.h></zlib.h> 后，所有函数都是全局符号，和你自己定义的 deflate 变量名冲突会导致静默错误。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
