zlib压缩需手动处理文件I/O和内存管理，compress()适合小文件但不可调参数，deflate()支持流式控制但需配对deflateEnd()；必须检查返回值、缓冲区状态及链接配置。
zlib 压缩文件前必须手动处理文件读写和内存管理
zlib 本身不提供 fopen 或 std::fstream 封装，它只做数据流压缩/解压。你得自己打开文件、读进缓冲区、调用 compress 或 deflate、再把结果写出去——漏掉任意一环都会导致空文件或乱码。
常见错误现象：compress() 返回 Z_OK 但输出文件打不开；或者压缩后体积反而变大（没设好压缩级别或原始数据太小）。
- 小文件（compress() 最省事；大文件（>1MB）必须用
deflate()流式处理，否则容易爆内存 -
compress()只接受Bytef*和uLongf*，注意指针类型和长度变量必须是无符号长整型，传错会导致段错误 - 压缩后数据长度要靠输出参数返回，不能用
strlen()判断——二进制流里可能含\0
compress() 和 deflate() 的选择取决于文件大小和控制粒度
compress() 是 zlib 提供的简化接口，适合一次读完、一次压完的小文件；deflate() 是底层流接口，支持分块输入、实时 flush、自定义窗口大小，但初始化麻烦、出错路径多。
使用场景举例：日志归档脚本用 compress() 足够；网络传输中边生成边压缩就得用 deflate()。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
compress()内部默认用Z_DEFAULT_COMPRESSION，没法改压缩级别；deflateInit2()可以指定level（-1 到 9）、method（Z_DEFLATED）、windowBits（影响内存和兼容性） -
deflate()必须配对调用deflateEnd()，否则内存泄漏；compress()没这问题 - 如果目标要兼容 Python
zlib.decompress()或 Node.jszlib.unzip()，windowBits = 15（默认）即可；若需 gzip 格式，得用compress2()或deflateInit2()配windowBits = 15 + 16
写入压缩文件时别忽略 zlib 的返回值和边界检查
zlib 函数返回 Z_OK 不代表一切顺利，Z_BUF_ERROR（输出缓冲不够）、Z_STREAM_END（流结束但你还想继续 deflate）这些状态必须显式处理，否则程序看似运行成功，实际只写了半截数据。
典型错误：用固定大小输出缓冲（比如 64KB），但没检查 deflate() 是否返回 Z_OK 还是 Z_STREAM_END，导致最后一点数据被丢弃。
- 每次调用
deflate()后，检查ret == Z_STREAM_END表示全部完成；ret == Z_OK表示还需更多输出空间；ret == Z_BUF_ERROR表示avail_out == 0且你没给新缓冲 - 写文件时，用
write()或fwrite()的返回值校验是否写满，不要假设“调用了就写成功” - 压缩失败（如
deflateInit()返回Z_MEM_ERROR）时，strm->msg可能为nullptr，直接printf("%s", strm->msg)会崩
Windows 下链接 zlib 需显式指定库名，Linux/macOS 容易漏 -lz
编译时报 undefined reference to `compress' 或类似错误，90% 是链接阶段没带 zlib 库。Windows 上 MSVC 用 #pragma comment(lib, "zlib.lib") 或命令行加 zlib.lib；GCC/Clang 必须加 -lz，且位置要在源文件之后。
兼容性影响：静态链接 libz.a 时，若项目同时用 OpenSSL（也依赖 zlib），可能因版本冲突导致 inflate() 崩溃；动态链接 zlib.dll 时，要确保运行时路径下有对应版本。
- macOS 上
brew install zlib后，头文件在/opt/homebrew/include/zlib.h，链接时加-L/opt/homebrew/lib -lz - Windows MinGW 编译需确认用的是
libz.dll.a而非zlibstatic.lib，后者要求定义ZLIB_WINAPI - CMake 项目中别只写
find_package(ZLIB)，还得target_link_libraries(your_target ${ZLIB_LIBRARIES})，否则find_package成功了也白搭
最常被跳过的一步：压缩完记得 fclose() 输出文件前调用 fflush()，尤其用 setvbuf() 改过缓冲模式时。zlib 不管文件句柄，它只管你传进来的内存块——你忘了刷盘，它真就不管。
