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