7zip-cpp：现代化 C++ 压缩解压库使用指南

文件传输优化

在网络传输场景中，使用 7zip-cpp 对文件进行压缩可以显著减少传输数据量，提升传输效率。

快速上手指南

环境准备

1. 确保系统中已安装 CMake 和 Git 工具
2. 准备好 Visual Studio 开发环境（支持 2013、2015、2017 等多个版本）

项目集成步骤

第一步：克隆项目

git clone <repository_url> --recursive

第二步：构建库文件

cd 7zip-cpp
mkdir build && cd build
cmake -G "Visual Studio 15 2017 Win64" ../
cmake --build . --config Release

第三步：在您的项目中使用 在 CMakeLists.txt 中添加：

add_subdirectory(7zip-cpp)
target_include_directories(您的项目 INTERFACE 7zip-cpp/Include)
target_link_libraries(您的项目 7zpp)

基础使用示例

加载 7z 库并创建压缩器：

#include <7zpp/7zpp.h>
SevenZip::SevenZipLibrary lib;
lib.Load(); // 加载 7z 动态库
// 创建压缩器
SevenZip::SevenZipCompressor compressor(lib, "archive.zip");
compressor.SetCompressionFormat(SevenZip::CompressionFormat::Zip);

进阶功能探索

自定义回调函数

7zip-cpp 支持进度回调，让您能够实时监控压缩解压进度：

class MyProgressCallback : public SevenZip::ProgressCallback {
public:
    virtual void OnProgress(ULONGLONG total, ULONGLONG completed) {
        // 更新进度显示
        std::cout << "进度：" << completed << "/" << total << std::endl;
    }
};

内存中操作

对于需要直接在内存中进行压缩解压的场景，项目提供了 OutMemStream 和 MemExtractCallback 等组件，支持完全的内存操作模式。

多格式支持

除了常见的 Zip 格式，7zip-cpp 还支持 7z、Tar、Gzip 等多种压缩格式，满足不同场景的需求。

通过 CompressionFormat.h 中定义的枚举，您可以轻松切换不同的压缩格式：

compressor.SetCompressionFormat(SevenZip::CompressionFormat::SevenZip); // 7z 格式
compressor.SetCompressionFormat(SevenZip::CompressionFormat::Tar); // Tar 格式

开发建议与最佳实践

1. 错误处理：虽然大部分函数返回布尔值表示操作结果，但仍建议使用 try-catch 块捕获可能的异常：

try {
    SevenZip::SevenZipExtractor extractor(lib, archiveName);
    extractor.ExtractArchive(destination);
} catch (SevenZip::SevenZipException& ex) {
    std::cerr << "操作失败：" << ex.GetMessage() << std::endl;
}

2. 路径管理：使用 UseAbsolutePaths(false) 可以避免在压缩包中保存绝对路径信息，这在跨平台部署时特别有用。

7zip-cpp 作为一个成熟稳定的开源项目，已经在众多实际项目中得到验证。无论您是初学者还是经验丰富的开发者，都能快速掌握并应用到实际开发中。