Pimpl idiom通过将实现细节移至.cpp文件中的私有类，并在头文件中仅保留指向其实例的指针，降低编译依赖、提升封装性与ABI稳定性；需注意析构函数和拷贝控制成员必须在实现文件中定义以避免不完整类型问题。
C++的Pimpl idiom（Pointer to Implementation）是一种常见的封装技巧，用来隐藏类的实现细节，减少编译依赖，提升代码的模块化和二进制兼容性。它的核心思想是将类的具体实现放在一个独立的结构体或类中，并通过一个指针在主类中引用它。
为什么需要Pimpl idiom
在C++中，头文件暴露了类的完整定义，包括所有成员变量和私有类型。一旦这些内容发生变化，所有包含该头文件的源文件都需要重新编译。这会增加构建时间，破坏接口与实现的分离。
Pimpl idiom通过把实现细节移到.cpp文件中，使得头文件只保留一个不透明的指针，从而：
- 降低编译依赖
- 提高编译速度
- 增强封装性
- 支持二进制接口稳定（ABI stability）
基本用法示例
假设我们有一个Widget类，内部使用了一些复杂的库类型（如std::string、std::vector等），我们希望把这些实现细节隐藏起来。
立即学习“C++免费学习笔记（深入）”；
头文件 widget.h：
#pragma once
#include <memory>
<p>class Widget {
public:
Widget();
~Widget();
Widget(const Widget&);
Widget& operator=(const Widget&);</p><pre class="brush:php;toolbar:false;">void doSomething();
int getValue() const;private:
class Impl; // 前向声明实现类
std::unique_ptr
实现文件 widget.cpp：
#include "widget.h"
#include <string>
#include <vector>
<p>class Widget::Impl {
public:
void doSomething() { /<em> 具体逻辑 </em>/ }
int getValue() const { return value; }</p><pre class="brush:php;toolbar:false;">int value = 42;
std::string name = "default";
std::vector<double> data{1.0, 2.0, 3.0};};
// 构造函数创建实现对象
Widget::Widget() : pImpl(std::make_unique
// 必须在.cpp中定义析构函数，因为 unique_ptr 需要知道 Impl 的完整类型 Widget::~Widget() = default;
// 拷贝构造和赋值也需要在.cpp中实现
Widget::Widget(const Widget& other)
: pImpl(std::make_unique
Widget& Widget::operator=(const Widget& other) { pImpl = other.pImpl; return *this; }
void Widget::doSomething() { pImpl->doSomething(); }
int Widget::getValue() const { return pImpl->getValue(); }
关键点说明
Pimpl idiom看似简单，但有几个容易忽略的关键点：
- 析构函数必须在.cpp中定义：因为std::unique_ptr在销毁时需要知道所指向类型的完整定义。如果在头文件中删除析构函数，默认析构函数会被隐式生成并尝试删除不完整类型，导致编译错误。
- 拷贝控制成员也需在.cpp中实现：同理，拷贝构造函数和赋值操作符如果使用默认行为或涉及unique_ptr对不完整类型的复制，也需要看到完整类型。
- 性能影响很小但存在：每次访问都要经过指针解引用，且对象多一次动态分配。但在大多数场景下，这种开销可以接受。
- 可用std::shared_ptr替代unique_ptr：如果你希望共享实现或延迟初始化，也可以使用shared_ptr，但unique_ptr更常见，因为它语义清晰且无额外开销。
现代C++中的变体与优化
为了进一步优化内存使用，可以采用“小对象优化”策略，比如Cheshire Cat模式结合placement new，或者使用std::variant + buffer预分配。不过这些属于高级技巧，一般项目中直接使用unique_ptr加前向声明已足够。
另一种简化写法是使用lambda配合局部静态变量实现惰性初始化，但Pimpl主要目的不是懒加载，而是解耦。
基本上就这些。Pimpl idiom不复杂但容易忽略细节，正确使用能显著改善大型项目的构建结构和维护性。尤其适用于库开发或频繁变动的模块中。
