unzGoToFirstFile 返回-1主因是ZIP文件未以只读模式打开、路径含中文/空格未UTF-8转义、不支持ZIP64或UTF-8文件名，或unzOpen失败（路径错/权限不足/文件损坏）。
minizip 读取 ZIP 目录时为什么 unzGoToFirstFile 返回 -1？
常见错误是没检查 ZIP 文件是否以只读模式打开，或路径含中文/空格但没做 UTF-8 转义。minizip（尤其是老版本）默认不支持 ZIP64 和 UTF-8 文件名，遇到这类 ZIP 会直接跳过所有条目，unzGoToFirstFile 返回 UNZ_END_OF_LIST_OF_FILE (-1)。
- 确保用
unzOpen打开文件后立即检查返回值是否非 NULL，NULL 表示打开失败（常因路径不存在、权限不足或文件损坏） - 若 ZIP 由 macOS / 新版 Windows 打包，大概率含 UTF-8 文件名，需在编译 minizip 时定义
UNICODE并用unzOpen2+ 自定义zlib_filefunc_def支持宽字符路径 - 不要依赖
unzGetGlobalComment判断 ZIP 是否有效——它可能成功返回但内部条目为空
C++ 递归打印 ZIP 内部目录树的关键逻辑在哪？
ZIP 本身没有“目录”概念，只有带斜杠的文件路径（如 assets/config.json 或 src/main.cpp）。所谓“目录树”，是你自己按 / 拆分路径、去重、排序后模拟出来的层级结构。
- 遍历每个文件项用
unzGetCurrentFileInfo获取szFileName，注意该字段结尾不一定有/，即使它是逻辑上的目录（ZIP 中目录项只是个末尾带/的空文件） - 提取所有唯一前缀：对每个
szFileName，逐级切掉最后一段（如a/b/c.txt→a/b/→a/），存入std::set<:string></:string>避免重复 - 打印时按长度升序排列前缀，再用缩进控制层级：每多一级
/就多两个空格，但要过滤掉根路径/（ZIP 中一般不存在）
用 unzLocateFile 查找特定文件为什么总失败？
unzLocateFile 对大小写敏感，且不自动补 /。比如 ZIP 里实际存的是 README.md，你传 "readme.md" 或 "README.md/" 都会失败。
- 先用
unzGoToFirstFile+unzGoToNextFile全量遍历，把所有szFileName存进std::map（key 为小写版，value 为原始名），再查表——比反复调unzLocateFile更稳 - 如果目标是目录（如
"images/"），得确认 ZIP 中确实存在该名称的条目（末尾带/），否则它只是隐式路径，不会被unzLocateFile匹配到 - 某些 ZIP 工具（如 7-Zip 默认设置）会省略空目录项，此时只能靠解析文件路径推断，不能依赖查找
Windows 下中文路径 ZIP 解压显示乱码怎么办？
根本原因不是编码转换没做，而是 minizip 1.x 系列默认用系统本地编码（如 GBK）读取文件名，而现代 ZIP 多用 UTF-8。强行转码反而错上加错。
立即学习“C++免费学习笔记（深入）”；
- 最简方案：改用 minizip2（即
minizip-ng），它原生支持 ZIP64 和 UTF-8，并提供mz_zip_reader_get_filename直接返回 UTF-8 字符串 - 若必须用老 minizip，可在
unzOpen2时传入自定义zlib_filefunc_def，其中zopen_file函数内用MultiByteToWideChar(CP_UTF8, ...)转宽字符，再交给系统 API - 别在控制台直接
std::cout —— Windows 控制台默认 ANSI 编码，需先调 <code>SetConsoleOutputCP(CP_UTF8)，且字体要支持 Unicode
