C++标准库不支持ZIP操作,需用libzip等第三方库;创建ZIP须用ZIP_CREATE标志并先删除同名文件,添加文件用zip_file_add(),写入后必调zip_close();解压需zip_open()只读打开、遍历条目并逐个读取或提取。

C++ 标准库不支持 ZIP 文件操作,必须依赖第三方库;最常用且跨平台的是 libzip 和 minizip(zlib 附带),推荐优先用 libzip——API 清晰、错误处理好、维护活跃。
用 libzip 创建 ZIP 归档(写入文件或内存)
libzip 提供 zip_open() + zip_file_add() 流程,注意默认是只读打开,创建新 ZIP 必须传 ZIP_CREATE 标志:
-
zip_t *za = zip_open("out.zip", ZIP_CREATE, &err);—— 若文件已存在,ZIP_CREATE不会覆盖,需先unlink("out.zip") - 添加文件用
zip_file_add(),第二个参数是 ZIP 内路径(支持子目录,如"data/config.json"),第三个参数是zip_source_t*,常从文件构建:zip_source_file(za, "input.txt", 0, 0) - 写入后必须调用
zip_close(za),否则文件为空或损坏;若中途出错,用zip_discard(za)安全释放 - 若想把 ZIP 写入内存(比如发 HTTP 响应),用
zip_source_buffer()构造 source,再zip_file_add(),最后用zip_stat_index()+zip_fopen_index()+zip_fread()提取二进制数据
用 libzip 解压 ZIP 归档(提取到磁盘或读取内容)
解压本质是遍历条目 + 逐个读取或写入文件,核心函数是 zip_get_num_entries() 和 zip_fopen_index():
- 打开 ZIP:
zip_t *za = zip_open("archive.zip", 0, &err);—— 第二个参数为 0 表示只读,别误写成ZIP_CREATE - 遍历所有条目:
for (int i = 0; i ,用 <code>zip_stat_index()获取元信息(名字、大小、是否目录) - 提取单个文件:先
zip_fopen_index()得到zip_file_t*,再循环zip_fread()读取数据,最后zip_fclose() - 写入磁盘时,务必检查并创建父目录(
libzip不自动建目录),路径需过滤"../"防止路径穿越攻击——这是常见安全疏漏
编译与链接 libzip 的关键细节
Linux/macOS 下通常用包管理器安装,但头文件和库名容易混淆:
立即学习“C++免费学习笔记(深入)”;
- Debian/Ubuntu:
sudo apt install libzip-dev,编译加-lzip,头文件是<zip.h></zip.h> - macOS Homebrew:
brew install libzip,但默认头文件在/opt/homebrew/include/zip.h,需加-I/opt/homebrew/include;链接仍用-lzip - Windows:建议用 vcpkg:
vcpkg install libzip:x64-windows,然后在 CMake 中find_package(libzip CONFIG),别手动找.lib - 注意:libzip 依赖
zlib,但多数发行版的libzip-dev已包含它;若手动编译 libzip,需先装 zlib 开发包,否则链接报undefined reference to 'deflate'
为什么不用 std::filesystem 或 Boost.Iostreams?
因为它们真的不支持 ZIP —— std::filesystem 只管本地路径和文件属性,Boost.Iostreams 的 zip_filter 仅支持解压流式输入(且已废弃多年),不能创建 ZIP,也不支持随机访问条目。有人试图用 zlib 原生 API 手搓 ZIP 格式,结果发现 ZIP 的中央目录结构、压缩方法标识、CRC 计算、文件时间戳编码全是坑,远不如直接用 libzip 稳定。
真正容易被忽略的是错误码处理:libzip 几乎每个函数都可能失败,zip_strerror() 和 zip_error_strerror() 返回的字符串不能直接 printf,因为内部可能含空字节;还有 ZIP 文件本身损坏时,zip_open() 可能返回非 NULL 但后续调用失败,必须始终检查每一步的返回值。


















