测试不应破坏封装,应遵循接口稳定、实现可换原则;禁用友元,改用pimpl、观察接口、依赖注入等方法,聚焦可观测行为而非内部实现。

测试本身不该成为破坏封装的借口。只要类设计时遵循“接口稳定、实现可换”原则,就完全不必为单元测试开后门。
别用友元(friend)给测试类开后门
友元是编译期硬编码的信任关系,一旦写上 friend class TestWidget,就等于把实现细节永久钉死在头文件里。后续任何重构——比如把 std::vector 换成 std::deque,或把内部状态拆成两个子类——都会迫使测试代码同步修改,甚至编译失败。
- 友元让测试和实现强耦合,违背“测试应只依赖接口”的基本前提
- 它暴露的是私有成员名、类型、布局,而这些本就不该是测试关心的
- CI 构建时若测试代码和产品代码分属不同 target(如静态库 vs 测试可执行文件),友元声明还可能因 ODR 违规引发未定义行为
用 Pimpl + 公共观察接口代替内部状态访问
真正需要验证的不是“内部 vector 里第 3 个元素是不是 42”,而是“调用 addUser("alice") 后,userCount() 是否返回 1”。把断言落在可观测行为上,而不是内存布局上。
- 在头文件中只提供纯接口函数,如
size()、isEmpty()、lastError(),它们不泄露实现结构 - Impl 类里可以自由使用
std::unordered_map或boost::multi_index,只要size()行为一致,测试就无需改动 - 如果真需调试级检查(比如验证缓存命中率),可通过临时启用的
debugInfo()成员函数返回结构体,且该函数仅在#ifdef DEBUG下可见
依赖注入比“暴露私有”更可控
当类依赖外部服务(如日志、网络、时间)时,与其把 m_logger 设为 public 让测试替换,不如在构造时传入抽象接口。
- 把
std::shared_ptr<ilogger></ilogger>作为构造函数参数,生产代码传真实实现,测试代码传 mock 对象 - 这样测试控制的是协作对象行为,而非被测类内部字段——既没破环封装,又覆盖了交互逻辑
- 避免出现“为了测一个 HTTP 调用,不得不在头文件里暴露
m_httpClient并 includeHttpClient.h”这种连锁污染
最难守住的其实是心理防线:当测试写不下去时,第一反应不该是“怎么把 private 改成 public”,而是“这个类的职责是不是太重了?它的接口是否已经无法准确表达行为意图?”。Pimpl 不是银弹,但它是提醒你——只要接口定义得足够干净,实现细节就真的可以锁进 .cpp 文件里,连编译器都看不见。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











