如何用 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 操作功能。
