怎样用C++处理压缩包内文件使用libzip操作ZIP归档内容-C++-PHP中文网

怎样用C++处理压缩包内文件使用libzip操作ZIP归档内容

P粉602998670

发布： 2025-06-30 13:46:02

原创

603人浏览过

如何用 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 实现添加或覆盖文件。注意错误处理、内存管理及路径一致性问题。

怎样用C++处理压缩包内文件使用libzip操作ZIP归档内容

处理压缩包内文件是很多项目中常见的需求，尤其是在需要读取或修改 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 模式打开。