用miniz可直接内存解压zip内文件：先init_file打开zip，再locate_file按路径查找（注意正斜杠和编码），接着get_file_info获取大小，malloc分配缓冲区后extract_to_mem解压，最后校验字节数并free释放。
用 miniz 直接读取 ZIP 内文件流，不落地不解压
核心是跳过解压到磁盘这步，直接从 ZIP 中定位并解码目标文件。C++ 标准库不支持 ZIP，得靠第三方轻量库，miniz 是最常用选择——单头文件、无依赖、支持只读流式解压。
关键不是“打开 ZIP”，而是“在 ZIP 中找到某路径的文件条目 → 获取其压缩数据 → 在内存中解压”。miniz 的 mz_zip_reader_extract_file_to_callback 或更底层的 mz_zip_reader_extract_file_to_mem 可以做到。
- 必须先调用
mz_zip_reader_init_file打开 ZIP 文件（非内存映射时传文件路径） - 用
mz_zip_reader_locate_file查找目标文件，注意路径分隔符必须是正斜杠/，即使 Windows 下也要写成"config.txt"或"data/log.csv" - 查不到返回 -1，常见原因是大小写不匹配或 ZIP 内实际路径含多余前缀（比如打包时带了
src/） - 提取到内存用
mz_zip_reader_extract_file_to_mem，传入缓冲区指针和大小；若不确定大小，先用mz_zip_reader_get_file_info拿uncomp_size
mz_zip_reader_extract_file_to_mem 的内存管理陷阱
这个函数不会帮你分配内存，你得自己 malloc 一块够大的空间，大小至少等于原始（未压缩）文件长度。如果估小了，它会静默截断，读出来的是乱码或缺内容——不会报错，但数据已损毁。
更稳妥的做法是两步走：先查元信息，再分配、再提取：
mz_zip_archive zip;
if (!mz_zip_reader_init_file(&zip, "bundle.zip", 0)) { /* 失败 */ }
int idx = mz_zip_reader_locate_file(&zip, "README.md", nullptr, 0);
if (idx == -1) { /* 文件不存在 */ }
mz_zip_archive_file_stat stat;
if (!mz_zip_reader_file_stat(&zip, idx, &stat)) { /* 获取失败 */ }
void* buf = malloc(stat.m_uncomp_size);
if (!buf) { /* 内存不足 */ }
size_t read_size = mz_zip_reader_extract_to_mem(&zip, idx, buf, stat.m_uncomp_size, 0);
if (read_size != stat.m_uncomp_size) { /* 解压出错或缓冲区不够 */ }
-
mz_zip_reader_extract_to_mem返回实际写入字节数，必须校验是否等于stat.m_uncomp_size - 不要用
std::vector<char></char>直接.data() 传进去——除非确保 capacity >= uncomp_size，否则行为未定义 - 释放内存必须用
free(buf)，不能用delete[]，因为malloc分配
中文路径或 UTF-8 文件名在 ZIP 中的兼容性问题
ZIP 规范本身对文件名编码没强制约定，老工具打的包常用 GBK（Windows）或 CP437（DOS），新工具多用 UTF-8。但 miniz 默认按原始字节比较，不做编码转换。
所以如果你代码里写 mz_zip_reader_locate_file(&zip, "说明.txt", nullptr, 0)，而 ZIP 里存的是 GBK 编码的字节序列，那就永远找不到。
- 最简单方案：统一用英文文件名，避免编码争议
- 若必须支持中文，需提前知道 ZIP 的编码方式，用对应编码把查找字符串转成字节再传入
-
miniz不提供自动编码探测，别指望它“智能识别”——它只做字节匹配 - Linux/macOS 下用 UTF-8 打的 ZIP，在 Windows 上用默认 locale 读可能失败，反之亦然
大 ZIP 包里频繁查找多个小文件的性能隐患
每次调用 mz_zip_reader_locate_file 都会线性扫描 ZIP 中央目录（Central Directory），O(n) 时间复杂度。如果 ZIP 有上千个文件，而你要查 10 个，就是 10×n 次扫描，很慢。
解决办法是预建哈希表，把所有文件名和索引缓存起来：
std::unordered_map<:string int> file_index; for (int i = 0; i <ul> <li>构建哈希表只需一次，之后查找 O(1)</li> <li>注意 <code>stat.m_filename</code> 是 C 字符串，以 \0 结尾，直接构造 <code>std::string</code> 安全</li> <li>如果 ZIP 文件会被外部修改，这个缓存就失效了——得重新构建</li> </ul> <p>真正麻烦的从来不是“怎么读”，而是 ZIP 文件本身不规范：路径混用反斜杠/正斜杠、编码随意、中央目录损坏、ZIP64 扩展未处理……这些情况 <code>miniz</code> 会静默失败或返回错误码，但不会告诉你具体哪一行坏了。</p></:string>
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
