minizip读取zip内文件需手动定位并分块读取，不可直接内存读取；必须检查unzOpen/unzLocateFile返回值，循环调用unzReadCurrentFile拼接内容，读完调用unzCloseCurrentFile。
minizip 读取 zip 包内文件内容（非解压到磁盘）
minizip 本身不提供“直接读取内存中文件内容”的高层接口，必须手动打开 zip、定位文件、分配缓冲区、调用 unzReadCurrentFile 分块读取。它不支持随机访问整个文件内容——你得自己拼接。
常见错误是调用 unzOpen 后没检查返回值，或在未成功调用 unzLocateFile 就直接 unzOpenCurrentFile，导致段错误或返回 UNZ_END_OF_LIST_OF_FILE 错误。
- 务必用
unzGoToFirstFile或unzLocateFile确认目标文件存在后再操作 - 调用
unzOpenCurrentFile前，确保当前 zip 条目已定位（unzGoToFirstFile→unzGoToNextFile循环匹配，或直接unzLocateFile("path/in/zip.txt", 0)） - 读取时建议每次不超过 64KB（如
char buf[65536]），避免栈溢出；大文件必须循环unzReadCurrentFile直到返回 0 - 读完必须调用
unzCloseCurrentFile，否则后续无法操作其他条目
unzFile zip = unzOpen("archive.zip");
if (!zip) { /* 处理打开失败 */ }
if (unzLocateFile(zip, "data/config.json", 0) != UNZ_OK) { /* 文件不存在 */ }
if (unzOpenCurrentFile(zip) != UNZ_OK) { /* 解压初始化失败 */ }
int len;
char buf[8192];
std::vector<char> content;
while ((len = unzReadCurrentFile(zip, buf, sizeof(buf))) > 0) {
content.insert(content.end(), buf, buf + len);
}
unzCloseCurrentFile(zip); // 关键！
unzClose(zip);
zlib 单独无法读 zip，但可处理 deflate 流（需自行解析 zip 结构）
zlib 库只提供 inflate / deflate 压缩算法，**不理解 zip 文件格式**。所谓“用 zlib 读 zip”本质是：你得自己解析 zip 的 local file header、central directory、data descriptor —— 这几乎等于重写 minizip 核心逻辑。
实际项目中，除非你做嵌入式裁剪或已有完整 zip parser，否则不要尝试绕过 minizip 直接用 zlib 处理 zip 内容。容易踩的坑包括：
立即学习“C++免费学习笔记（深入）”；
- 忽略 zip 中的 extra field（导致 header 解析偏移错位）
- 未处理 ZIP64 扩展（大文件/大量文件时
unz_file_info.size_file为 0xFFFFFFFF） - 误把加密标志（bit 1 of general purpose bit flag）当普通数据读，触发解压失败
- zlib inflate 初始化前未重置
z_stream的next_in/avail_in，导致 inflate 返回Z_DATA_ERROR
minizip2 与 legacy minizip（minizip 1.x）关键差异
新版 minizip2（GitHub 上的 nih-at/libzip 衍生版）API 完全不兼容旧版，函数名加了 mz_ 前缀，且默认使用 C++ 友好接口（如 mz_zip_reader_init_file）。legacy minizip（常随 zlib 源码一起分发）仍广泛用于旧项目，但缺乏对 zip64、UTF-8 路径、密码保护等现代特性的健壮支持。
- legacy minizip 的
unzLocateFile对大小写敏感，且不支持通配符；minizip2 的mz_zip_reader_locate_file可传flags = MZ_ZIP_FLAG_CASE_SENSITIVE控制 - legacy 版本读取含中文路径 zip 时，若系统 locale 不匹配，
unzLocateFile可能失败；minizip2 默认按 UTF-8 解释文件名 - legacy 版本无内置密码支持（需 patch 或自行 hook
unzOpenCurrentFilePassword）；minizip2 通过mz_zip_reader_set_password提供统一入口
Windows 下编译 minizip 静态链接常见报错
在 MSVC 中链接 minizip 时，最常遇到的是 LNK2019: unresolved external symbol _unzOpen —— 本质是没把 minizip.lib 加入链接器输入，或 C/C++ 语言运行时库不一致（如 minizip 编译用 /MT，主工程用 /MD）。
- 确认
unzip.c和ioapi.c已加入项目，并启用 C 语言编译（.c 文件属性 → “C/C++” → “高级” → “编译为” = “编译为 C 代码”） - 如果使用预编译 zlib（如 vcpkg 安装的
zlib:x64-windows），确保 minizip 源码中#include "zlib.h"能正确找到头文件，且链接时同时指定zlib.lib和minizip.lib - legacy minizip 默认定义
ZLIB_WINAPI，若你没定义，需在预处理器中添加，否则 Windows API 调用（如CreateFileA）符号不匹配 - 64 位构建时，
unz_file_info中的size_file类型是uLong（32 位），但 zip64 实际需要uLong64—— 必须启用UNZIP_SUPPORT_ZIP64宏并重新编译 minizip
实际集成时，最易被忽略的是：zip 文件路径中的反斜杠（\）在 C 字符串里要写成 \，而 minizip 内部一律用正斜杠（/）做分隔符。传入 unzLocateFile 的路径字符串必须用 /，哪怕你在 Windows 上构造路径。
