C++用libzip解压ZIP文件教程

如何用 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 库。不同系统的安装方式略有不同：

• 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 
#include 

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