Pimpl模式下头文件仅前向声明Impl可避免调用方重编译，但析构函数等必须定义在.cpp中；std::unique_ptr支持前向声明，公有接口不变是免重编译前提。
头文件里没暴露实现细节，编译器就看不到变动
调用方（比如 main.cpp）只包含你的头文件，而该头文件中对 Impl 只有前向声明：class Impl;，没有定义、没有 #include 任何实现相关头文件。编译器在处理调用方时，根本不知道 Impl 里有啥字段、用没用 std::vector、是否新增了 Config 成员——它只知道“那是个类型，大小固定（指针大小），我只管调用函数”。所以你改 widget.cpp 里的 struct Widget::Impl，对调用方完全透明。
析构函数必须定义在 .cpp 文件里，否则会触发重编译
这是最容易踩的坑：如果把 ~Widget() 留在头文件里不定义（哪怕只写个 = default），编译器会在每个包含该头文件的翻译单元里隐式生成析构逻辑，而这需要知道 Impl 是完整类型——但头文件里只有前向声明，不满足条件，轻则报错 invalid use of incomplete type，重则链接失败或 ODR 违规。正确做法是：
- 在头文件中只声明
~Widget(); - 在
widget.cpp中定义Widget::~Widget() = default;或显式delete pImpl; - 同理，拷贝/移动构造函数、赋值运算符若涉及
pImpl管理，也必须定义在 .cpp 中
std::unique_ptr 比裸指针更安全，且不强制要求 Impl 完整定义
std::unique_ptr 的构造、析构、重置等操作只要求 Impl 在使用点是“完整类型”，而它的默认删除器（default_delete）的特化却是在定义点才需要完整类型。这意味着：
- 头文件里用
std::unique_ptr<impl></impl>是合法的，只要Impl前向声明即可 - 只要析构函数实现在 .cpp 文件中（此时
Impl已完整定义），就能安全释放内存 - 裸指针虽然也能用，但得手动
new/delete，容易漏掉异常安全处理
公有接口签名不变，才是重编译豁免的前提
Pimpl 不是万能的“免编译开关”。它只保证：当且仅当以下全部成立时，调用方才真正无需重编译：
立即学习“C++免费学习笔记（深入）”；
- 头文件中未新增/删减任何
public函数或数据成员 - 所有公有函数的签名（参数类型、返回类型、
const限定）完全没变 - 没改动基类列表、模板参数、友元声明等影响 ABI 的东西
- 没在头文件里偷偷加
#include实现依赖（比如为了用std::string而在头文件里#include <string>）
一旦动了公有接口，或者把本该藏在 .cpp 里的头文件拖进 .h，Pimpl 的防火墙就立刻失效——这恰恰是最常被忽略的复杂点：Pimpl 的有效性，高度依赖开发者对“什么该露、什么该藏”的持续自律。
