用libzip解压单个文件最直接，应调用zip_name_locate()定位条目索引，再用zip_fopen_index()和zip_fread()流式读取，避免遍历所有条目；注意路径分隔符、大小检查及zip_fl_unchanged标志使用。
用 libzip 解压单个文件最直接
如果你只是想从 ZIP 包里读出某个特定路径的文件内容（比如 config.json），不落地解压、不遍历所有条目，libzip 是最轻量且可控的选择。它支持随机访问 ZIP 中任意条目，无需先解压整个包。
常见错误是调用 zip_open() 后直接 zip_get_num_entries() + 循环找名字——这其实绕远了。正确做法是用 zip_name_locate() 直接定位条目索引，再用 zip_fopen_index() + zip_fread() 流式读取。
-
zip_name_locate()第二个参数建议传ZIP_FL_UNCHANGED，避免因 ZIP 中有数据描述符或加密标记导致定位失败 - 如果目标文件路径含 Windows 风格反斜杠（
"data\image.png"），libzip默认只认正斜杠；要么提前替换为"data/image.png"，要么编译时定义ZIP_WINDOWS_PATH - 读取前务必检查
zip_stat_t中的size字段，避免为超大文件（如几百 MB）一次性malloc导致 OOM
用 minizip（zlib 附带）需手动跳过无关条目
minizip 本身不提供按名查找接口，它的 unzLocateFile() 可以用，但行为不稳定：遇到同名多条目（如大小写不同、重复压缩）时可能返回第一个而非精确匹配项，且不区分路径分隔符。
更稳妥的做法是用 unzGoToFirstFile() + unzGoToNextFile() 遍历，对每个 unz_file_info 调用 unzGetCurrentFileInfo() 拿到 szFileName，字符串比较后再决定是否打开。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 比较文件名时记得忽略尾部斜杠（ZIP 中目录条目常以
/结尾，而你要的是普通文件） -
unzOpenCurrentFilePassword()如果 ZIP 有密码，必须在unzOpenCurrentFile()前调用，否则后续读取会静默失败 - 读取后必须调用
unzCloseCurrentFile()，否则下次unzOpenCurrentFile()会失败并返回UNZ_CRCERROR
别碰 std::filesystem 或 7z.dll 直接解压
C++20 的 std::filesystem 完全不支持 ZIP；而 7z.dll 虽然功能强，但它的 C API（ISzArEx）需要自己处理 LZMA 解码、文件系统模拟、密码派生等底层逻辑，光是初始化一个 CFileExtractCallback 就要 200 行以上胶水代码——只为读一个文件，得不偿失。
除非你已经在项目中深度集成 7-Zip SDK 且需要同时处理 7z/RAR/TAR，否则纯 ZIP 场景下引入它只会让构建变慢、ABI 兼容性变差、错误堆栈难以追踪。
- Windows 上有人试过用
ShellExecute调tar.exe（Win10+ 自带），但tar -xf archive.zip path/in/zip在路径含空格或中文时极易崩，且无法获取读取结果状态码 - Python 的
zipfile.ZipFile.open()看似简单，但嵌入 Python 解释器进 C++ 进程的成本远高于链接一个libzip静态库
内存映射 ZIP 文件？不行
有人想把整个 ZIP 文件 mmap 进来，然后手动解析本地文件头找目标条目偏移——理论上可行，但实际几乎没人这么做。ZIP 格式允许条目顺序与中央目录顺序不一致，且支持数据描述符、ZIP64 扩展、加密字段等变长结构，手撕解析极易漏判边界条件。
哪怕你只处理自己生成的、无加密、无 ZIP64 的 ZIP，也建议优先用 libzip 的 zip_source_buffer_create() 把内存块包装成 zip_source_t，再走标准流程打开，而不是自己算偏移。
-
zip_source_buffer_create()的第四个参数设为0表示数据不可变，可避免libzip内部做额外拷贝 - 若 ZIP 数据来自网络流（如 HTTP 响应体），不要用
zip_source_buffer_create()，改用zip_source_function_create()实现按需拉取，否则内存占用不可控
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
