开发者应该掌握的思想谱系（七）PIMPL

一句话核心

把类的私有成员隐藏到一个内部类里，公开类只保留一个指向内部类的指针。

没有 PIMPL：你把家里的贵重物品、私密日记都放在客厅茶几上。每个来家里的客人都能看到。

有 PIMPL：你把贵重物品锁在一个保险柜里，客厅里只放一个保险柜的钥匙。客人只能看到钥匙，看不到里面的东西。

先看没有 PIMPL 的代码

// widget.h class Widget : public QWidget { private: // 这些私有成员全部暴露在头文件里 QTimer* m_timer; QList<QString> m_data; DatabaseManager m_db; ConfigManager m_config; LogManager m_log; public: Widget(); void doSomething(); };

问题：

1. 任何包含widget.h的文件，都要编译这些私有成员

2. 修改私有成员（比如加一个变量），所有包含widget.h的文件都要重新编译

3. 私有成员暴露在头文件里，不够隐藏

有 PIMPL 的写法

第一步：公开类只放一个指针

// widget.h（对外暴露） class Widget : public QWidget { private: class Impl; // 声明内部类 std::unique_ptr<Impl> m_impl; // 只放一个指针 public: Widget(); ~Widget(); void doSomething(); };

第二步：内部类放真正的私有成员

// widget.cpp（不对外暴露） class Widget::Impl { public: // 真正的私有成员都放这里 QTimer* timer; QList<QString> data; DatabaseManager db; ConfigManager config; LogManager log; }; Widget::Widget() : m_impl(std::make_unique<Impl>()) { m_impl->timer = new QTimer(this); m_impl->db.connect(); } Widget::~Widget() = default; void Widget::doSomething() { m_impl->db.save("data"); }

什么时候你会用到 PIMPL？

场景1：你写的类被很多其他类包含

// config_manager.h（被 100 个文件包含） class ConfigManager { private: // 如果这里加了新成员，100 个文件都要重新编译 QString m_filePath; QMap<QString, QString> m_cache; QMutex m_mutex; // ... 还有很多 };

用 PIMPL 后，加新成员只重新编译config_manager.cpp，其他 100 个文件不用动。

场景2：你给别人提供 SDK（动态库）

你想让别人只用你的头文件和 DLL，不想暴露私有成员。PIMPL 是标准做法。

场景3：你的项目编译很慢（超过 1 分钟）

如果修改一个头文件，整个项目要重新编译很久，可以考虑对核心类用 PIMPL。

五、你现在的项目需要 PIMPL 吗？

大概率不需要。

你现在的项目：

• 你一个人开发

• 规模不大

• 编译速度可以接受

不需要为了用而用，PIMPL 会带来额外的复杂度。

总结

PIMPL 是一个“高级优化”工具，不是日常必需品。先理解它的思想，等真正需要时再用。