Pimpl idiom通过将私有实现移至独立类并仅在头文件中保留指向它的指针，以减少编译依赖、加快编译速度、提升二进制兼容性；需在.cpp中定义Impl及Widget的析构、拷贝等特殊成员函数，避免头文件中暴露Impl细节。
C++中的Pimpl idiom（Pointer to Implementation，指针指向实现）是一种通过将类的私有成员数据和实现细节移到一个独立的、不对外暴露的类中，并在主类中仅保留一个指向该实现类的指针，从而隔离接口与实现的技术。它的核心目标是减少头文件的编译依赖，加快编译速度，提升二进制兼容性。
为什么需要Pimpl？
当一个类的私有成员（比如std::vector、std::string、自定义类对象等）直接写在头文件里时，任何修改都会导致所有包含该头文件的源文件重新编译——即使改动只影响内部逻辑，与用户代码无关。Pimpl把这部分“易变”的实现挪到.cpp文件里，头文件只剩一个不透明指针（通常是std::unique_ptr<Impl>），这样只要接口不变，实现怎么改都不会触发下游重编译。
基本写法要点
- 头文件中只声明私有指针（如class Widget; class WidgetImpl; std::unique_ptr<WidgetImpl> pImpl;），不定义WidgetImpl；
- 在.cpp中完整定义WidgetImpl，并实现Widget的构造、析构、拷贝/移动操作（尤其注意：析构函数必须在.cpp中定义，否则unique_ptr无法调用Impl的析构器）；
- 避免在头文件中使用Impl的大小或成员，否则会破坏不透明性；
- 若需支持拷贝，通常要手动实现深拷贝逻辑（因为默认的unique_ptr拷贝会被禁用）。
常见陷阱和注意事项
容易忽略的是：析构函数、拷贝构造函数、赋值运算符如果在头文件中是默认生成或只声明未定义，会导致链接错误或不完整类型错误。正确做法是在.cpp中显式定义它们（哪怕只是= default）。另外，Pimpl会带来一次间接内存访问开销和额外的堆分配，对性能极度敏感的场景需权衡。
它不是万能的
Pimpl主要解决的是**头文件稳定性和编译依赖**问题，不解决运行时多态、接口抽象或设计模式层面的解耦。它也不能替代良好的模块划分；如果一个类本就不该被频繁包含，或者实现极少变动，强行套用Pimpl反而增加复杂度。
立即学习“C++免费学习笔记（深入）”；
基本上就这些。用得好，能让大型项目的增量编译快很多；用得随意，反而让代码更难读、更易出错。
