unzGoToFirstFile 返回 -1 主因是路径错误、文件不存在、权限不足或 ZIP 格式不兼容（如 ZIP64 未启用支持）；unzOpen 成功不保证结构合法，需逐函数校验返回值。
minizip 读取 ZIP 文件列表时为何 unzGoToFirstFile 返回 -1
常见错误是 ZIP 文件路径不对、文件不存在、权限不足，或 ZIP 格式不兼容（比如含 ZIP64 扩展但未启用支持）。unzOpen 成功不代表 ZIP 结构合法——它只检查魔数和基础结构，后续遍历才暴露真实问题。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
unzOpen后立刻检查返回值是否为NULL，不是就直接失败，别跳过 - 确保 ZIP 文件是普通 ZIP（非分卷、非加密、不含 ZIP64 头），否则需在编译 minizip 时定义
UNZIP_SUPPORT_ZIP64 - Windows 下注意路径用正斜杠或双反斜杠：
"data/archive.zip"或"data\archive.zip"，单反斜杠会触发转义 - Linux/macOS 上确认文件可读：
ls -l data/archive.zip，避免静默失败
如何用 unzGoToFirstFile + unzGoToNextFile 安全遍历文件名
这两个函数不是“自动迭代器”，每次调用都依赖前一次状态。跳过 unzGoToFirstFile 直接调 unzGoToNextFile 必然失败；中间任何一步出错（如文件名超长、编码异常）都可能导致指针错乱。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 必须先调
unzGoToFirstFile，成功后再进循环，不能假设它总成功 - 每次
unzGetCurrentFileInfo前，用unz_file_info结构体清零，避免旧数据干扰szFileName长度判断 - 文件名缓冲区至少分配
MAXFILENAME + 1字节（MAXFILENAME通常为 256），并手动置末尾为 - 示例关键片段：
unzFile zip = unzOpen("a.zip"); if (!zip) return; if (unzGoToFirstFile(zip) != UNZ_OK) { /* 处理错误 */ } do { unz_file_info info; char filename[MAXFILENAME + 1] = {0}; if (unzGetCurrentFileInfo(zip, &info, filename, sizeof(filename)-1, NULL, 0, NULL, 0) == UNZ_OK) { printf("%s ", filename); } } while (unzGoToNextFile(zip) == UNZ_OK);
为什么 unzGetCurrentFileInfo 里的 filename 有时是空或乱码
根本原因是 ZIP 中文件名按原始字节存储，无统一编码声明。minizip 不做 UTF-8 转换，遇到中文名时若源 ZIP 用 GBK 打包，而你按 UTF-8 解释，就会显示为乱码或截断——这不是函数 bug，是编码契约没对齐。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 开发阶段优先用英文文件名测试，排除编码干扰
- 若必须支持中文，打包方需明确使用 UTF-8 存储文件名（如 7-Zip 勾选 “UTF-8 for file names”），且 ZIP 中需设置通用位标志第 11 bit（
0x0800） - 不要依赖
info.size_filename判断长度，它可能包含内部 ；始终以sizeof(filename)-1为上限，并手动补 - Linux/macOS 下可用
file -i a.zip粗略看 ZIP 是否含 UTF-8 标志位（不保证准确）
C++ 封装时如何避免 unzClose 崩溃或资源泄漏
minizip 是纯 C 接口，没有 RAII。常见坑是：异常抛出时跳过 unzClose、多次 close 同一 handle、或把 unzFile 当智能指针误用。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用 RAII 包一层：构造函数调
unzOpen，析构函数调unzClose，并在析构中判空（if (m_zip) unzClose(m_zip); m_zip = NULL;） - 禁止拷贝，只允许移动（
= delete拷贝构造/赋值，实现移动构造） - 不要在
unzGoToNextFile循环里提前break后忘记 close——RAII 是最稳妥解法 - 若集成到现有项目，注意 minizip 默认不带 C++ 异常安全，所有 C 调用点都应加
try/catch(...)保底（尤其unzOpen内部可能 malloc 失败）
最易被忽略的点：ZIP 文件头损坏时，unzOpen 可能返回非 NULL 的伪 handle，后续任意操作都可能崩溃——务必对每个 API 调用结果校验，不能只信第一个。
