【C++】头文件引入的一种陋习

（点击上方公众号，可快速关注）

简介

C++从C继承的基于头文件的类型检查，特别容易出问题，估计每个人都会遇到典型的循环引用的问题。而我最近在几个项目中遇到不少头文件引入不规范的情况，给使用造成了很大的麻烦。最主要的只有一种：就是不管青红皂白，都将依赖的头文件放在.h里include，造成的主要问题就是细节外露。

细节外露

假设有一个TestLibrary的库，.h和.cpp文件如下。可以看到该库实现使用了boost库，所以在.h文件显式引入了相应的头文件，但实际上头文件中TestLibrary的声明完全不依赖boost库，只有.cpp中才用到了boost库。

#ifndef TESTLIBRARY_H
#define TESTLIBRARY_H

#include <boost/unordered_map.hpp>

class TestLibrary {
public:
    TestLibrary();
    TestLibrary(const TestLibrary& orig);
    virtual ~TestLibrary();
    
public:
    bool test();
};

#endif /* TESTLIBRARY_H */

#include "TestLibrary.h"

TestLibrary::TestLibrary() {
}

TestLibrary::TestLibrary(const TestLibrary& orig) {
}

TestLibrary::~TestLibrary() {
}

bool TestLibrary::test() {
    boost::unordered_map hash;
    //省略
}

如果你将该库提供给别人使用，你的使用者必须得引入boost/unordered_map.hpp，这无形中给你的使用者增加了依赖。我们在编写代码时，尽量不要把实现的细节暴露给使用者，以上的例子完全可以把头文件的引入放在.cpp里。在实际的代码中，可能会使用到第三方的网络库、json库等等，如果将这些依赖完全暴露给使用者，没人会用你的代码。

看了好多人写的代码，这种情况还是挺多的，虽然道理懂，但真正地落实到底还是有差距的。编写代码要时刻谨记以下两个原则，才能从意识上杜绝这类情况。

• 声明和实现要分离

• 作用域最小化