如何用 c++++ 的 libzip 库操作 zip 文件？1. 安装 libzip：ubuntu/debian 用 apt-get，macos 用 homebrew，windows 用 vcpkg 或源码编译；2. 打开 zip 文件并读取文件列表，使用 zip_open、zip_get_num_entries 和 zip_get_name 遍历所有文件名；3. 读取 zip 内部文件内容，通过 zip_file_open 和 zip_file_read 分块读取数据至字符串；4. 向 zip 添加或更新文件，使用 zip_file_add 结合 zip_source_file 实现添加或覆盖文件。注意错误处理、内存管理及路径一致性问题。
处理压缩包内文件是很多项目中常见的需求，尤其是在需要读取或修改 ZIP 档内容的场景下。如果你正在使用 c++，那么 libzip 是一个非常实用的库，它支持创建、读取、修改 ZIP 文件，并且跨平台兼容性也不错。
下面我来分享一下如何用 libzip 来操作 ZIP 归档中的文件内容。
1. 安装和配置 libzip
在开始编码之前，你需要先确保系统中已经安装了 libzip 库。不同系统的安装方式略有不同：
立即学习“C++免费学习笔记（深入）”；
-
Ubuntu/Debian：
sudo apt-get install libzip-dev
-
macos（Homebrew）：
brew install libzip
-
windows：可以通过 vcpkg 或 MSYS2 安装，也可以自行下载源码编译。
安装完成后，在你的 C++ 项目中记得链接 libzip 库，比如在 g++ 编译命令中加上 -lzip。
2. 打开 ZIP 文件并读取文件列表
使用 libzip 的第一步通常是打开 ZIP 文件，然后获取其中包含的所有文件名。
#include <zip.h> #include <iostream> void list_files_in_zip(const std::string& zip_path) { int err = 0; zip* archive = zip_open(zip_path.c_str(), 0, &err); if (!archive) { std::cerr << "无法打开 ZIP 文件" << std::endl; return; } zip_int64_t num_entries = zip_get_num_entries(archive, 0); for (zip_int64_t i = 0; i < num_entries; ++i) { const char* name = zip_get_name(archive, i, 0); if (name) std::cout << "文件: " << name << std::endl; } zip_close(archive); }
这段代码会列出 ZIP 文件中所有条目的名称。注意 zip_get_name() 可能返回 NULL，所以最好加个判断。
3. 从 ZIP 中读取文件内容
如果想读取某个文件的内容，可以使用 zip_file_open() 和 zip_file_read() 函数组合完成。
std::string read_file_from_zip(const std::string& zip_path, const std::string& file_name) { int err = 0; zip* archive = zip_open(zip_path.c_str(), 0, &err); if (!archive) { std::cerr << "无法打开 ZIP 文件" << std::endl; return ""; } zip_file* file = zip_file_open(archive, file_name.c_str(), 0); if (!file) { std::cerr << "无法打开 ZIP 中的文件: " << file_name << std::endl; zip_close(archive); return ""; } char buffer[1024]; std::string content; zip_int64_t bytes_read; while ((bytes_read = zip_file_read(file, buffer, sizeof(buffer), 0)) > 0) { content.append(buffer, bytes_read); } zip_file_close(file); zip_close(archive); return content; }
这个函数会把指定文件的内容读入一个字符串中。适用于文本文件或者小体积的二进制文件。
4. 向 ZIP 添加新文件或更新已有文件
有时候你可能想向 ZIP 包里添加新文件或者替换已有的文件。这需要用到 zip_file_add() 和写入接口。
bool add_file_to_zip(const std::string& zip_path, const std::string& target_name, const std::string& source_path) { int err = 0; zip* archive = zip_open(zip_path.c_str(), ZIP_CREATE, &err); if (!archive) { std::cerr << "无法打开 ZIP 文件进行写入" << std::endl; return false; } zip_source* src = zip_source_file(archive, source_path.c_str(), 0, -1); if (!src) { std::cerr << "无法创建文件源" << std::endl; zip_close(archive); return false; } zip_int64_t idx = zip_file_add(archive, target_name.c_str(), src, ZIP_FL_OVERWRITE); if (idx == -1) { std::cerr << "添加文件失败" << std::endl; zip_source_free(src); zip_close(archive); return false; } zip_close(archive); return true; }
这段代码会将指定路径的文件添加到 ZIP 包中，并允许覆盖同名文件。注意 ZIP 文件必须以 ZIP_CREATE 模式打开。
小贴士和注意事项
- 使用 libzip 时，错误处理非常重要。每个调用都可能失败，建议都加上对应的判断。
- 如果要处理大文件，不要一次性全部读入内存，而是分块处理。
- ZIP 文件路径在 Windows 和 linux 下可能有差异，注意统一使用 / 路径分隔符。
- 修改 ZIP 文件时，原文件会被锁定，直到调用 zip_close()，记得释放资源。
基本上就这些。用 libzip 处理 ZIP 文件并不复杂，但需要注意细节，尤其是内存管理和错误检查。只要熟悉了基本流程，就可以灵活地实现各种 ZIP 操作功能。
