pimpl模式的核心作用是解耦头文件依赖、缩短编译时间并隐藏实现细节；需用前向声明+std::unique_ptr持有不完整类型impl，析构函数必须在.cpp中定义以确保impl完整可见。
什么是Pimpl模式的核心作用
它不是为了“封装”而封装，而是为了解耦头文件依赖、缩短编译时间、隐藏实现细节（比如第三方库类型、内部数据结构变更），同时保持接口稳定。关键在于：类的公有接口头文件里不暴露任何私有成员的具体类型，连 std::vector、std::string 这类标准类型都不能直接出现在头文件的私有区。
如何正确声明Pimpl类（头文件部分）
必须用不完整类型（incomplete type）前向声明私有实现类，并用 std::unique_ptr 持有它；不能用裸指针，否则资源管理易出错；也不能用 std::shared_ptr，除非真需要共享所有权——多数场景下只是单例式内部实现。
- 在头文件中只写
class Impl;前向声明，不包含任何Impl的定义或头文件 - 公有类中只保留
std::unique_ptr<impl> pimpl_;</impl>成员，且必须是最后一个成员（避免因移动构造/赋值导致未定义行为） - 显式默认或删除特殊成员函数：
Foo() = default;、Foo(Foo&&) = default;、Foo& operator=(Foo&&) = default;、~Foo() = default;—— 但注意：析构函数若为= default，就必须在实现文件中可见Impl的完整定义，否则链接失败
为什么析构函数不能在头文件里 = default
因为 std::unique_ptr<impl></impl> 的析构器需要知道 Impl 是什么类型才能调用其析构函数。如果头文件里只有前向声明，编译器无法生成正确的析构代码，会报类似 invalid application of 'sizeof' to incomplete type 'Impl' 的错误。
- 正确做法：在实现文件（.cpp）中提供析构函数定义，此时已包含
Impl定义 - 或者把析构函数声明为
= default，但必须确保该声明出现在实现文件中（即类定义在头文件，析构函数定义在 .cpp） - 如果忘了这条，编译器不会立刻报错，直到你使用了隐式生成的析构（比如局部变量离开作用域），问题才浮现
实现文件中怎么组织 Impl 类和接口转发
所有具体逻辑都移入 .cpp，包括 Impl 的完整定义、成员函数实现、以及公有接口对 pimpl_ 的调用转发。这里最容易漏的是拷贝语义——Pimpl 默认不支持拷贝，除非你显式实现深拷贝逻辑。
-
Impl可以是匿名命名空间内的 struct，避免符号污染 - 每个公有函数只需简单转发：例如
void Foo::DoWork() { pimpl_->DoWork(); } - 若需支持拷贝，不要直接拷贝
pimpl_（那是浅拷贝），而应实现Impl的拷贝构造，再在Foo的拷贝构造函数中 new 一个新Impl - 注意异常安全：
std::make_unique<impl>()</impl>可能抛异常，若在构造函数中调用，需确保不泄漏资源
Impl。否则改一次内部实现，整个项目的头文件依赖链就重新编译一遍。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
