1. 项目概述与核心价值

最近在做一个需要处理大量用户上传文件的C++后台服务，其中一个核心需求就是高效、可靠地压缩和解压文件。市面上压缩库不少，但既要开源免费，又要支持格式广泛、性能强悍，7-Zip的LZMA SDK几乎是绕不开的选择。直接用命令行调用7z.exe当然简单，但在高并发、需要精细控制压缩过程的后台服务里，把7zip库（准确说是LZMA SDK）集成到自己的C++代码里，才是更专业、更可控的方案。这不仅能避免进程创建的开销，还能让我们自定义压缩参数、处理进度回调，甚至实现流式压缩，直接把压缩数据通过网络发送出去。

这个项目，就是带你一步步走通在C++项目中集成并使用7zip库进行压缩的完整流程。无论你是想为你的桌面应用添加一个强大的压缩引擎，还是像我一样为服务器后端集成压缩功能，这篇文章都会把从环境准备、库编译、代码集成到实战调试的每一个坑都填平。我会假设你已经有基本的C++和CMake使用经验，但即使你是第一次接触7zip库，跟着做下来也能搞定。

2. 7zip库生态与LZMA SDK选型解析

2.1 7-Zip、7z.dll与LZMA SDK：理清关系

很多人一上来就找“7zip库”，结果发现源头混乱，容易走弯路。首先必须理清几个关键概念：

• 7-Zip：这是一个完整的、广为人知的文件压缩归档软件，由Igor Pavlov开发。我们平时用的7zFM.exe（图形界面）或7z.exe（命令行）就是这个软件。
• 7z.dll：这是7-Zip软件的核心动态链接库，实现了7z、Zip、Gzip、Bzip2、Tar等多种格式的压缩、解压逻辑。一些第三方软件（如某些文件管理器）会通过COM接口调用这个dll来添加压缩功能。但是，对于C++集成，直接使用7z.dll的COM接口并不是最推荐的方式，它更适用于脚本或需要与7-Zip软件共存的场景。
• LZMA SDK：这才是我们C++开发者应该关注的“库”。它是7-Zip压缩算法（LZMA/LZMA2）以及其归档格式（7z）的官方软件开发工具包，以C++源代码形式提供。它包含了压缩/解压的核心算法实现（C目录）、一些辅助工具代码（CPP目录）以及用于创建7z格式的代码（CPP/7zip）。我们集成到C++项目里的，正是编译后的LZMA SDK静态库或动态库。

所以，我们的目标不是去调用一个现成的7z.dll，而是把LZMA SDK的源代码编译成我们自己的库（比如lzma.lib或lzma.dll），然后链接到我们的程序中。

2.2 获取与准备LZMA SDK

官方源码托管在SourceForge上。为了避免直接下载可能遇到的网络问题，一个更可靠的方式是通过其GitHub镜像仓库。

1. 获取源码：访问https://github.com/kornelski/7z或官方源https://www.7-zip.org/sdk.html。GitHub仓库通常更新及时，且方便用Git管理。我们以命令行方式为例：

   git clone https://github.com/kornelski/7z.git lzma-sdk cd lzma-sdk

   克隆后，目录结构大致如下：

   lzma-sdk/ ├── C/ # 核心的C语言算法实现（LZMA编解码器） ├── CPP/ # C++封装和工具类 │ ├── 7zip/ # 7z格式相关代码（我们主要用这里） │ │ ├── Common/ # 通用工具（文件流、字符串等） │ │ ├── Archive/ # 各种归档格式（7z, Zip等）的实现 │ │ └── ... │ └── Windows/ # Windows特定代码（非Windows平台可忽略或适配） ├── DOC/ # 文档（很有用！） └── ... # 其他目录

2. 理解目录结构：对于基础的压缩/解压，我们最关心的是CPP/7zip/Archive和CPP/7zip/Common。C/目录下的代码是算法内核，性能极高，但接口较底层；CPP/7zip下的类是对这些内核的面向对象封装，更易用。

注意：LZMA SDK的代码风格比较古老，大量使用宏定义和特定的类型（如UInt32,Byte），并且异常处理方式可能和现代C++项目不同。初次接触需要一点适应时间。

3. 编译LZMA SDK为静态库

直接在自己的项目中包含所有.cpp文件会非常混乱，最佳实践是先将其编译成独立的静态库（.lib/.a）或动态库。这里我们以编译一个最小化的、支持7z格式压缩解压的静态库为例，使用CMake进行跨平台管理。

3.1 创建CMake构建脚本

在你的工作区创建一个新目录，比如cpp-7zip-integration，然后建立如下结构：

cpp-7zip-integration/ ├── lzma-sdk/ # 刚才克隆的SDK源码 ├── lib/ # 存放编译好的库文件 ├── include/ # 存放需要暴露的头文件（可选，也可以直接引用源码目录） └── CMakeLists.txt # 主CMake文件

主CMakeLists.txt内容如下：

cmake_minimum_required(VERSION 3.15) project(LZMA_SDK_Static) # 设置C++标准 set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 定义库的源码文件集合 set(LZMA_SDK_SRC # 核心通用工具 lzma-sdk/CPP/7zip/Common/FileStreams.cpp lzma-sdk/CPP/7zip/Common/FilterCoder.cpp lzma-sdk/CPP/7zip/Common/InBuffer.cpp lzma-sdk/CPP/7zip/Common/OutBuffer.cpp lzma-sdk/CPP/7zip/Common/StreamObjects.cpp lzma-sdk/CPP/7zip/Common/StreamUtils.cpp lzma-sdk/CPP/7zip/Common/VirtThread.cpp # 7z格式编解码器 lzma-sdk/CPP/7zip/Archive/7z/7zCompressionMode.cpp lzma-sdk/CPP/7zip/Archive/7z/7zDecode.cpp lzma-sdk/CPP/7zip/Archive/7z/7zEncode.cpp lzma-sdk/CPP/7zip/Archive/7z/7zExtract.cpp lzma-sdk/CPP/7zip/Archive/7z/7zFolderInStream.cpp lzma-sdk/CPP/7zip/Archive/7z/7zFolderOutStream.cpp lzma-sdk/CPP/7zip/Archive/7z/7zHandler.cpp lzma-sdk/CPP/7zip/Archive/7z/7zHandlerOut.cpp lzma-sdk/CPP/7zip/Archive/7z/7zIn.cpp lzma-sdk/CPP/7zip/Archive/7z/7zOut.cpp lzma-sdk/CPP/7zip/Archive/7z/7zProperties.cpp lzma-sdk/CPP/7zip/Archive/7z/7zRegister.cpp # 归档格式通用接口 lzma-sdk/CPP/7zip/Archive/ArchiveExports.cpp lzma-sdk/CPP/7zip/Archive/Common/HandlerOut.cpp lzma-sdk/CPP/7zip/Archive/Common/ItemNameUtils.cpp # 压缩/解压通用逻辑 lzma-sdk/CPP/7zip/Compress/LzmaDecoder.cpp lzma-sdk/CPP/7zip/Compress/LzmaEncoder.cpp # 可能需要的一些基础工具 lzma-sdk/CPP/Common/MyWindows.cpp # 提供Windows API的模拟或封装，跨平台需要 lzma-sdk/CPP/Common/MyString.cpp lzma-sdk/CPP/Common/StringConvert.cpp lzma-sdk/CPP/Common/StringToInt.cpp lzma-sdk/CPP/Common/UTFConvert.cpp lzma-sdk/CPP/Common/Vector.cpp ) # 添加静态库目标 add_library(lzma_static STATIC ${LZMA_SDK_SRC}) # 设置头文件包含路径。非常重要，因为SDK内部头文件引用关系复杂。 target_include_directories(lzma_static PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk/C ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk/CPP ) # 根据平台设置编译定义 if(WIN32) target_compile_definitions(lzma_static PUBLIC _WIN32 _7ZIP_ST) else() target_compile_definitions(lzma_static PUBLIC _7ZIP_ST) endif() # 安装目标（可选） install(TARGETS lzma_static ARCHIVE DESTINATION lib) install(DIRECTORY lzma-sdk/ DESTINATION include/lzma-sdk FILES_MATCHING PATTERN "*.h")

3.2 编译与可能遇到的问题

1. 生成构建系统：在项目根目录打开终端。

   mkdir build cd build cmake .. -DCMAKE_BUILD_TYPE=Release

   这里-DCMAKE_BUILD_TYPE=Release指定生成Release版本的库，体积更小，速度更快。

2. 执行编译：

   cmake --build . --config Release

   在Windows上，这会调用MSVC生成lzma_static.lib；在Linux/macOS上，会生成liblzma_static.a。

3. 常见编译错误与解决：

   • 错误：MyWindows.h找不到或相关Windows类型未定义。
     • 原因：在非Windows平台，SDK用MyWindows.h和MyWindows.cpp模拟了部分Windows API（如DWORD,CreateFile等）。你需要确保MyWindows.cpp在源文件列表中，并且_WIN32宏在非Windows平台不能被定义。上面的CMakeLists通过if(WIN32)已经处理了。
   • 错误：大量未定义的引用，链接失败。
     • 原因：很可能遗漏了某些必需的.cpp文件。LZMA SDK的模块间依赖比较紧密。如果只编译了7z相关文件但后续想用Zip，就会缺文件。解决方案是根据你需要的格式，参考lzma-sdk/CPP/7zip/Archive下对应格式的.cpp文件，以及CPP/7zip/Common下的基础文件，逐步添加到LZMA_SDK_SRC列表中。一个稳妥的方法是先编译7-Zip官方提供的7z.dll工程（在lzma-sdk/CPP/7zip/Bundles目录下有示例），看它包含了哪些文件。
   • 警告：语言扩展、安全警告等。
     • 处理：对于MSVC，可以在target_compile_options中添加/W0来暂时禁用所有警告（不推荐），或者更精细地禁用特定警告。对于GCC/Clang，可以用-Wno-*系列选项。建议先确保编译通过，再考虑清理警告。

实操心得：第一次编译LZMA SDK静态库可能会花费一两个小时在排查文件依赖上。一个非常有效的捷径是直接使用网络上一些成熟的开源项目（如cpp-7zip）已经写好的CMake或Makefile，在其基础上修改。这能节省大量时间。

4. 在C++项目中集成与调用

假设我们已经成功编译出了lzma_static.lib（Windows）或liblzma_static.a（Linux）。现在创建一个简单的测试项目来验证压缩功能。

4.1 创建测试项目结构

cpp-7zip-integration/ ├── lzma-sdk/ # SDK源码 ├── lib/ # 编译好的库文件 (liblzma_static.a 或 lzma_static.lib) ├── include/ # 我们整理好的头文件（或直接指向lzma-sdk目录） ├── src/ # 我们的测试代码 │ └── main.cpp └── CMakeLists.txt # 测试项目的CMake文件

4.2 编写压缩功能的核心代码

在src/main.cpp中，我们将实现一个最简单的功能：将一个本地文件压缩成.7z格式。这里会用到SDK中的几个关键类：

• CInFileStream: 用于读取原始文件的输入流。
• COutFileStream: 用于写入压缩后文件的输出流。
• NArchive::N7z::CHandler: 7z格式的处理器，提供了压缩和解压的接口。
• CArchiveUpdateCallback: 一个回调类，用于在压缩过程中提供文件信息、数据等。

以下是详细的代码实现和注释：

// main.cpp // 定义此宏以使用静态链接的7zip SDK #define _7ZIP_ST #include <stdio.h> #include <tchar.h> // 包含必要的7zip SDK头文件。注意路径，假设我们将lzma-sdk目录放在了include路径下。 #include "CPP/7zip/Archive/7z/7zHandler.h" #include "CPP/7zip/IPassword.h" #include "CPP/7zip/Common/FileStreams.h" #include "CPP/7zip/Common/StreamUtils.h" #include "CPP/Common/MyCom.h" #include "CPP/Common/MyString.h" #include "CPP/Common/Defs.h" // 使用7zip命名空间 using namespace NWindows; using namespace NFile; using namespace NDir; using namespace NArchive; using namespace N7z; // 一个简单的更新回调类，继承自SDK提供的接口。 // 在这个简单示例中，我们只处理单个文件，且不设置密码。 class CArchiveUpdateCallback: public IArchiveUpdateCallback2, public ICryptoGetTextPassword2, public CMyUnknownImp { public: // 实现必要的COM查询接口宏 MY_UNKNOWN_IMP2(IArchiveUpdateCallback2, ICryptoGetTextPassword2) // 需要更新的文件信息 UString FilePath; UString FileNameInArchive; // 在压缩包内的名称 CArchiveUpdateCallback(const wchar_t* filePath, const wchar_t* nameInArchive) : FilePath(filePath), FileNameInArchive(nameInArchive) {} // ---------- IProgress 接口 ---------- STDMETHOD(SetTotal)(UInt64 /* total */) { return S_OK; } STDMETHOD(SetCompleted)(const UInt64* /* completeValue */) { return S_OK; } // ---------- IArchiveUpdateCallback2 接口 ---------- STDMETHOD(GetUpdateItemInfo)(UInt32 /* index */, Int32 *newData, Int32 *newProperties, UInt32 *indexInArchive) { // 对于新创建的压缩包，所有项目都是新的 if (newData) *newData = BoolToInt(true); if (newProperties) *newProperties = BoolToInt(true); if (indexInArchive) *indexInArchive = (UInt32)(Int32)-1; return S_OK; } STDMETHOD(GetProperty)(UInt32 index, PROPID propID, PROPVARIANT *value) { // 我们只有一个文件，索引为0 if (index != 0) return E_INVALIDARG; NWindows::NCOM::CPropVariant prop; switch (propID) { case kpidPath: prop = FileNameInArchive; break; case kpidIsDir: prop = false; break; case kpidSize: { // 获取文件大小 NWindows::NFile::NFind::CFileInfo fileInfo; if (!fileInfo.Find(FilePath)) return GetLastError_noZero_HRESULT(); prop = (UInt64)fileInfo.Size; break; } case kpidAttrib: { NWindows::NFile::NFind::CFileInfo fileInfo; if (!fileInfo.Find(FilePath)) return GetLastError_noZero_HRESULT(); prop = (UInt32)fileInfo.Attrib; break; } case kpidCTime: case kpidATime: case kpidMTime: { NWindows::NFile::NFind::CFileInfo fileInfo; if (!fileInfo.Find(FilePath)) return GetLastError_noZero_HRESULT(); FILETIME ft; switch (propID) { case kpidCTime: ft = fileInfo.CTime; break; case kpidATime: ft = fileInfo.ATime; break; case kpidMTime: ft = fileInfo.MTime; break; default: return E_FAIL; } prop = ft; break; } default: prop = (UInt64)0; // 其他属性返回默认值 } prop.Detach(value); return S_OK; } STDMETHOD(GetStream)(UInt32 index, ISequentialInStream **inStream) { // 同样，只有一个文件 if (index != 0) return E_INVALIDARG; CInFileStream *inFileStreamSpec = new CInFileStream; CMyComPtr<ISequentialInStream> inStreamLoc(inFileStreamSpec); // 打开文件 if (!inFileStreamSpec->Open(FilePath)) return GetLastError_noZero_HRESULT(); *inStream = inStreamLoc.Detach(); return S_OK; } STDMETHOD(SetOperationResult)(Int32 /* operationResult */) { return S_OK; } // ---------- ICryptoGetTextPassword2 接口 ---------- STDMETHOD(CryptoGetTextPassword2)(Int32 *passwordIsDefined, BSTR *password) { // 本例不设置密码 *passwordIsDefined = false; *password = NULL; return S_OK; } }; int _tmain(int argc, _TCHAR* argv[]) { // 参数检查：程序名 源文件 目标压缩文件 if (argc != 3) { _tprintf(_T("Usage: %s <source_file> <dest_7z_file>\n"), argv[0]); return 1; } // 初始化COM（在Windows上是必须的，因为SDK内部使用了COM风格的接口） // 在非Windows平台，这个函数可能是空实现。 CoInitialize(NULL); HRESULT result = S_OK; try { // 1. 创建7z格式处理器 CMyComPtr<IOutArchive> archive; archive = new NArchive::N7z::CHandler; // 2. 创建输出文件流（压缩包） COutFileStream *outFileStreamSpec = new COutFileStream; CMyComPtr<ISequentialOutStream> outStream(outFileStreamSpec); if (!outFileStreamSpec->Create(argv[2], true)) // true 表示创建新文件，覆盖已存在 { _tprintf(_T("ERROR: Cannot create output file %s\n"), argv[2]); return 1; } // 3. 创建更新回调对象 CArchiveUpdateCallback *updateCallbackSpec = new CArchiveUpdateCallback(argv[1], argv[1]); CMyComPtr<IArchiveUpdateCallback2> updateCallback(updateCallbackSpec); // 4. （可选）设置压缩属性。这是控制压缩率、线程数等参数的关键步骤。 CMyComPtr<ISetProperties> setProperties; if (archive.QueryInterface(IID_ISetProperties, &setProperties) == S_OK) { const wchar_t *names[] = { L"x", L"mt" }; // 属性名：压缩等级(x)，多线程(mt) const int kNumProps = sizeof(names) / sizeof(names[0]); NWindows::NCOM::CPropVariant values[kNumProps]; values[0] = (UInt32)5; // 压缩等级 0-9，5是默认平衡值 values[1] = (UInt32)4; // 使用4个线程进行压缩 result = setProperties->SetProperties(names, values, kNumProps); if (result != S_OK) { _tprintf(_T("WARNING: Failed to set properties, continuing with defaults.\n")); } } // 5. 执行压缩操作！ // 参数说明：outStream - 输出流 // NULL - 需要更新的项目数量（NULL表示从回调中获取） // updateCallback - 回调接口 result = archive->UpdateItems(outStream, 1, updateCallback); if (result != S_OK) { _tprintf(_T("ERROR: Compression failed with HRESULT = 0x%08X\n"), result); } else { _tprintf(_T("Successfully compressed '%s' to '%s'\n"), argv[1], argv[2]); } } catch(...) { _tprintf(_T("ERROR: An unexpected exception occurred.\n")); result = E_FAIL; } // 清理COM CoUninitialize(); return (result == S_OK) ? 0 : 1; }

4.3 测试项目的CMake配置

在项目根目录的CMakeLists.txt中，我们需要链接刚才编译好的静态库。

cmake_minimum_required(VERSION 3.15) project(Test7zCompress) set(CMAKE_CXX_STANDARD 11) # 添加可执行文件 add_executable(test_7z_compress src/main.cpp) # 包含7zip SDK的头文件 target_include_directories(test_7z_compress PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk/C ${CMAKE_CURRENT_SOURCE_DIR}/lzma-sdk/CPP ) # 链接我们编译的静态库 target_link_libraries(test_7z_compress PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/lib/liblzma_static.a # Linux/macOS # ${CMAKE_CURRENT_SOURCE_DIR}/lib/lzma_static.lib # Windows ) # 如果是Windows，可能需要链接额外的系统库 if(WIN32) target_link_libraries(test_7z_compress PRIVATE Ole32.lib OleAut32.lib) endif()

编译并运行这个测试程序：

mkdir build_test && cd build_test cmake .. -DCMAKE_BUILD_TYPE=Release cmake --build . --config Release # 运行 ./test_7z_compress ./some_large_file.txt ./output.7z

如果一切顺利，你将看到压缩成功的提示，并生成一个output.7z文件，可以用7-Zip软件正常打开。

5. 高级配置、问题排查与性能调优

5.1 关键压缩参数详解

在代码中，我们通过ISetProperties接口设置了x和mt属性。LZMA SDK支持许多属性来精细控制压缩行为，以下是一些最常用的：

重要提示：设置d（字典大小）时务必考虑目标环境的内存。例如，设置d=28（256MB字典）意味着压缩和解压时都需要至少256MB的连续内存来存放字典。如果解压端内存不足，将无法解压文件。

5.2 常见编译与运行时问题排查

1. 链接错误：undefined reference to ...

   • 症状：编译测试程序时，链接器报错找不到CreateObject、GetHandlerProperty等符号。
   • 原因：静态库lzma_static.lib中没有包含这些函数的实现。它们位于格式注册文件中。
   • 解决：确保你的静态库编译时包含了对应格式的Register.cpp文件。对于7z格式，就是7zRegister.cpp。检查你的LZMA_SDK_SRC列表是否包含了它。

2. 运行时崩溃或断言失败

   • 症状：程序启动即崩溃，或在压缩过程中崩溃。
   • 排查：
     • 调试构建：尝试用Debug模式编译并运行，查看具体的断言信息或异常位置。
     • COM初始化：在Windows上，确保CoInitialize(NULL)在调用任何SDK功能之前被正确执行。
     • 内存对齐：某些平台（如ARM）对内存对齐敏感。确保你的编译选项没有改变默认的对齐方式。LZMA SDK的代码可能对特定结构体有对齐要求。
     • 文件路径：确保传递给SDK的文件路径是有效的，并且程序有读写权限。SDK内部使用宽字符（wchar_t），在Windows上直接传递argv即可，在Linux/macOS上可能需要转换。

3. 压缩结果损坏或无法解压

   • 症状：生成的.7z文件7-Zip软件打不开，或解压后内容错误。
   • 排查：
     • 输出流未关闭：确保在UpdateItems调用后，输出流对象（COutFileStream）才被销毁。在代码中，由于使用了CMyComPtr智能指针，会在作用域结束时自动释放，顺序是正确的。
     • 属性设置错误：检查传递给SetProperties的属性名和值是否正确。属性名是大小写敏感的。
     • 回调实现错误：仔细检查CArchiveUpdateCallback中GetProperty和GetStream的实现，确保返回了正确的文件大小、属性，并且正确打开了文件流。

5.3 性能优化实践

1. 多线程压缩：这是提升压缩速度最有效的手段。设置mt属性为你的物理核心数（例如4、8、16）。注意，超线程带来的逻辑核心数可能收益递减。
2. 权衡压缩等级与字典大小：对于日志、文本等可压缩性高的文件，提高压缩等级（x=7）收益明显。对于图片、视频等已压缩数据，使用低等级（x=1或x=0）可以飞快完成“压缩”（实际是打包）。字典大小（d）对压缩率影响大，但内存开销也大。对于网络传输或嵌入式环境，务必限制字典大小。
3. 流式压缩：上述示例是将整个文件读入再压缩。对于超大文件，可以实现真正的流式接口。你需要自定义实现ISequentialInStream接口，使其在Read方法被调用时从你的数据源（如网络socket、数据库）读取数据。这样可以在数据到达时实时压缩并发送，无需等待整个文件。
4. 内存池：在高并发服务中，频繁创建和销毁CInFileStream、COutFileStream等对象可能带来开销。可以考虑实现一个简单的对象池来重用这些对象。

6. 扩展应用：支持更多格式与封装工具类

6.1 添加Zip格式支持

7zip SDK同样支持创建Zip格式。只需在编译静态库时，额外添加Zip格式相关的源文件，并在代码中使用对应的Handler。

1. 修改静态库编译：在CMakeLists.txt的LZMA_SDK_SRC列表中，添加Zip相关的文件：

   lzma-sdk/CPP/7zip/Archive/Zip/ZipHandler.cpp lzma-sdk/CPP/7zip/Archive/Zip/ZipHandlerOut.cpp lzma-sdk/CPP/7zip/Archive/Zip/ZipIn.cpp lzma-sdk/CPP/7zip/Archive/Zip/ZipOut.cpp lzma-sdk/CPP/7zip/Archive/Zip/ZipRegister.cpp

   重新编译静态库。

2. 修改测试代码：在main.cpp中，将创建Handler的代码改为：

   #include "CPP/7zip/Archive/Zip/ZipHandler.h" ... // 创建Zip处理器 archive = new NArchive::NZip::CHandler;

   属性设置也需要调整，Zip格式的属性名可能与7z不同（例如压缩等级属性可能是x，也可能是0）。需要查阅SDK文档或源代码（ZipHandlerOut.cpp）来确定。

6.2 封装成易用的工具类

将上述繁琐的COM接口调用封装成一个简单的C++类，会极大提升代码的复用性和可读性。

// SevenZipCompressor.h #pragma once #include <string> #include <vector> class SevenZipCompressor { public: struct FileItem { std::wstring sourcePath; // 磁盘上的路径 std::wstring archivePath; // 在压缩包内的路径 }; SevenZipCompressor(); ~SevenZipCompressor(); // 设置压缩等级 (0-9) void SetCompressionLevel(int level); // 设置线程数 void SetThreadCount(int threads); // 设置字典大小 (如 24 表示 2^24 = 16MB) void SetDictionarySize(int sizeBits); // 压缩单个文件 bool CompressFile(const std::wstring& srcFile, const std::wstring& destArchive); // 压缩多个文件到一个压缩包 bool CompressFiles(const std::vector<FileItem>& files, const std::wstring& destArchive); // （可选）添加进度回调接口 void SetProgressCallback(std::function<void(const std::wstring&, UInt64, UInt64)> callback); private: // 内部实现，持有COM对象指针等 class Impl; std::unique_ptr<Impl> pImpl; };

在.cpp文件中实现这个类，内部就是我们将前面main.cpp中的逻辑模块化。这样，业务代码中只需要几行：

SevenZipCompressor compressor; compressor.SetCompressionLevel(7); compressor.SetThreadCount(4); if (compressor.CompressFile(L"input.big", L"output.7z")) { std::cout << "压缩成功！" << std::endl; }

这种封装隐藏了7zip SDK的复杂性，使核心业务逻辑清晰明了，也是在实际项目中推荐的做法。