直接用minizip最稳妥，它轻量成熟、支持中文路径和目录还原、ZIP64及CRC校验；而unzip.cpp等老代码不支持ZIP64、中文处理脆弱、无CRC校验且易内存泄漏。
直接用 minizip 是最稳妥的选择，别自己重写 ZIP 解析逻辑。它轻量、成熟、支持中文路径和目录结构还原，且与 zlib 绑定紧密，Windows/Linux 都能跑。
为什么不用 unzip.cpp / zip.cpp 这类老代码
网上流传的 unzip.cpp 和 zip.cpp（来自 info-zip 早期分支）问题不少：不支持 ZIP64、对中文路径处理靠 mbstowcs 硬转、CloseZipZ 和 CloseZipU 的资源释放行为不一致，容易内存泄漏。更关键的是——它们不校验 CRC32，解压损坏包时静默失败，你根本不知道文件已损坏。
-
unzip.cpp读中央目录时假设所有条目在文件末尾连续排列，但现代 ZIP（尤其含注释或扩展字段）可能破坏该假设 - 没有流式解压能力，必须把整个 ZIP 文件读入内存才能开始解析
- 路径拼接用
strcat_s+MAX_PATH，遇到长路径直接截断或缓冲区溢出
minizip 的正确初始化方式
别直接调 unzOpen 后就开读。先检查文件可读性、是否真为 ZIP 格式，再设置解压回调——尤其是路径安全校验，防止 ../ 路径遍历攻击。
- 用
unzOpen2_64替代unzOpen，确保 ZIP64 支持（大于 4GB 的包必用） - 传入的
unzFile必须配对调unzClose，否则句柄泄漏；Windows 下还可能锁住文件导致后续无法删除 - 调
unzGoToFirstFile前，先用unzGetGlobalInfo拿总文件数，避免空包或损坏包导致死循环
示例片段：
立即学习“C++免费学习笔记（深入）”；
unzFile uf = unzOpen2_64(zipPath.c_str(), nullptr);
if (!uf) { /* 文件不存在或不是 ZIP */ }
unz_global_info64 gi;
unzGetGlobalInfo64(uf, &gi); // 注意是 &gi，不是 gi
if (gi.number_entry == 0) { /* 空包，提前退出 */ }解压时重建目录结构的关键点
ZIP 文件里存的是相对路径字符串，比如 "src/main.cpp" 或 "docs/./readme.txt"，不能直接拼到目标目录后 CreateDirectory。必须逐级检查并创建缺失父目录。
- 用
std::filesystem::path（C++17）拆分路径，比手写find_last_of('\')更安全 - 对每个文件项，先取
unzGetCurrentFileInfo得到szFileName，再做路径规范化（移除"./"、折叠"a/../b"） - 创建目录前，用
std::filesystem::exists检查是否已存在，避免重复调用 API 报错 - 写文件前，务必用
std::ofstream(..., std::ios::binary)打开，否则 Windows 下换行符会被篡改
容易被忽略的错误场景
真正上线时卡住你的，往往不是“解压失败”，而是这些边界情况没处理：
- ZIP 中有同名文件夹和文件（如
"log"是文件，"log/"是目录），unzGetCurrentFileInfo不暴露目录标志位，得靠结尾是否有'/'判断，但某些打包工具会省略斜杠 - 密码保护 ZIP：
minizip默认不支持，需自行集成crypt.c并启用ZLIB_WINAPI宏，否则unzOpen直接返回NULL，无提示 - 目标路径磁盘空间不足：写文件时
ofstream::write返回值可能小于预期，但很多人只检查is_open()
最麻烦的是：ZIP 中某个文件 CRC 校验失败，unzOpenCurrentFile 成功，但 unzReadCurrentFile 返回负值——这个错误码不会自动传播，必须每次读完都手动检查返回字节数是否匹配声明长度。
