包装模式通过创建中间层类将不兼容接口转换为客户端期望的接口，常用于旧系统与新模块对接、第三方库适配及多版本库兼容。例如，将C风格日志函数封装为面向对象的Logger类，或为不同版本的数据处理函数提供统一的DataProcessor接口。还可通过模板实现通用包装，如将C函数包装为std::function，提升灵活性与复用性。该模式核心是解耦接口差异，对外暴露稳定接口，内部封装兼容逻辑，是C++中处理接口不匹配的实用技术。
在C++开发中，当需要集成不同系统、库或版本的组件时，接口不兼容是常见问题。包装模式（Wrapper Pattern）是一种有效手段，用于解决接口兼容性问题，使原本无法协同工作的类能够一起工作。
什么是包装模式
包装模式，也称适配器模式（Adapter Pattern）的一种实现方式，通过创建一个中间层类，将一个类的接口转换成客户端期望的另一个接口。这个中间类即“包装器”，它封装原始类，对外暴露统一或兼容的新接口。
包装模式常用于以下场景：
- 旧系统接口与新模块不匹配
- 第三方库接口不符合本地代码风格或需求
- 多个不同接口的类需要统一调用方式
通过包装器实现接口兼容
假设有一个旧的日志库，提供C风格接口：
立即学习“C++免费学习笔记（深入）”；
void log_write(const char* msg); int log_init();
而新代码期望使用面向对象的接口：
class Logger {
public:
virtual ~Logger() = default;
virtual void write(const std::string& msg) = 0;
virtual bool initialize() = 0;
};
此时可以创建一个包装器类，桥接两者：
class LegacyLoggerWrapper : public Logger {
public:
bool initialize() override {
return log_init() == 0;
}
<pre class='brush:php;toolbar:false;'>void write(const std::string& msg) override {
log_write(msg.c_str());
}};
这样，原有C函数被封装进符合现代C++接口的类中，新旧代码可以无缝协作。
处理多版本接口兼容
在维护长期项目时，依赖库可能升级，接口发生变化。包装模式可以帮助你屏蔽版本差异。
例如，假设库V1有函数：
void process_data_v1(int* data, int len);
而V2改为：
bool process_data_v2(const std::vector<int>& data);
可以定义统一接口：
class DataProcessor {
public:
virtual ~DataProcessor() = default;
virtual void process(const std::vector<int>& data) = 0;
};
再分别实现不同版本的包装：
class V1Processor : public DataProcessor {
public:
void process(const std::vector<int>& data) override {
process_data_v1(const_cast<int*>(data.data()), data.size());
}
};
<p>class V2Processor : public DataProcessor {
public:
void process(const std::vector<int>& data) override {
process_data_v2(data);
}
};</p>上层代码无需关心底层版本，只需使用
DataProcessor指针即可。
模板化包装提升灵活性
对于通用性较强的包装需求，可以使用模板进一步提升复用性。
例如，包装任意C风格回调函数为std::function：
template<typename Func, Func* func_ptr>
class CFunctionWrapper {
public:
void operator()(const std::string& s) {
func_ptr(s.c_str());
}
};
<p>// 使用示例
using LogWrapper = CFunctionWrapper<void(<em>)(const char</em>), log_write>;</p>这种方式可以在编译期完成绑定，避免运行时开销。
基本上就这些。包装模式通过引入中间层，有效解耦接口差异，是处理C++接口兼容问题的实用手段。关键在于识别变化点，设计稳定对外接口，将不兼容的细节封装在内部。不复杂但容易忽略。
