Effective C++ 条款31：将文件间的编译依存关系降至最低

条款31：将文件间的编译依存关系降至最低

为了减少编译依赖关系，应该将接口与实现分离，并尽量减少头文件之间的依赖。这有助于加快编译速度，降低因代码变化引起的编译重新构建的时间。

最小化编译依赖关系的最佳实践

1. 分离接口和实现
   将类的接口和实现分开，通常做法是将接口声明放在头文件中，而将实现代码放在源文件中。这样做可以避免头文件频繁改变导致的重新编译。

// Widget.h: 声明接口
class Widget {
public:void display();
};// Widget.cpp: 实现
#include "Widget.h"
void Widget::display() {// 实现代码
}

2. 使用 object reference 或 object pointer 替代 object
   当使用对象时，如果对象引用或指针足以完成任务，尽量不要直接传递整个对象。通过引用或指针传递可以减少对象的拷贝，降低编译时依赖。

// 如果只需要访问对象，可以使用引用
void processWidget(const Widget& widget);  // 只传递引用

3. 使用 class 声明式替换 class 定义式
   为了减少编译依赖，应该尽量在头文件中只提供类声明，而将类的实现放在源文件中。通过这种方式，其他文件仅依赖于声明，减少了编译时的依赖性。

// Widget.h: 仅声明
class Widget;// Widget.cpp: 定义
#include "Widget.h"
void Widget::display() {// 实现代码
}

4. 使用 Handle class 或 Interface class
   使用 “Handle class” 和 “Interface class” 是一种常见的降低编译依赖的技术。Handle class 通常是一个不包含数据的类，只包含指针或者引用，避免了类的完整定义暴露。Interface class 是一个纯虚类，表示类的接口，所有实现细节都隐藏在派生类中。

// WidgetHandle.h: 声明类的接口
class WidgetHandle {
public:virtual void display() = 0;  // 纯虚函数
};// WidgetHandle.cpp: 实现
#include "WidgetHandle.h"
// 实现函数

5. 使用声明式和定义式的不同头文件
   通过将声明和定义分开到不同的头文件中，可以使头文件的编译依赖最小化。声明文件只包含类的接口，而定义文件包含类的实现。

// WidgetDecl.h: 声明
class Widget;// WidgetDef.h: 定义
#include "WidgetDecl.h"
class Widget {
public:void display() { ... }
};

通过减少编译依赖的好处

• 加快编译速度：减少依赖关系的传递，避免无关代码的重新编译，减少编译时间。
• 提高可维护性：代码修改时不必修改过多的依赖文件，降低了维护成本。
• 提高灵活性：依赖于声明而不是定义使得系统的扩展性和灵活性更高。修改实现不需要重新编译所有依赖该实现的文件。

总结

• 分离接口和实现：通过分离接口和实现，减少了文件之间的依赖关系。
• 引用或指针传递：避免直接传递对象，尽量使用引用或指针来减少拷贝和依赖。
• 声明式替代定义式：尽可能在头文件中只提供声明，避免暴露实现细节。
• 使用 Handle 和 Interface 类：通过 handle 类和接口类设计模式来最小化依赖关系，增强系统的灵活性。

减少编译依赖关系是提升大型项目可维护性和编译效率的关键，遵循这些原则有助于构建高效且易于扩展的系统。