本文解释了一种使用Doxygen解析来删除#include的技术。这只是一个perl脚本，所以它很容易使用。

有两种类型的多余的#include文件:

头文件实际上不需要 模块(.c， .cpp) 模块需要头文件 而是不止一次，直接或间接地。

根据我的经验，有两种方法可以很好地检测到它:

gcc -H or cl.exe /showincludes (resolve problem 2) In real world, you can export CFLAGS=-H before make, if all the Makefile's not override CFLAGS options. Or as I used, you can create a cc/g++ wrapper to add -H options forcibly to each invoke of $(CC) and $(CXX). and prepend the wrapper's directory to $PATH variable, then your make will all uses you wrapper command instead. Of course your wrapper should invoke the real gcc compiler. This tricks need to change if your Makefile uses gcc directly. instead of $(CC) or $(CXX) or by implied rules. You can also compile a single file by tweaking with the command line. But if you want to clean headers for the whole project. You can capture all the output by: make clean make 2>&1 | tee result.txt PC-Lint/FlexeLint(resolve problem both 1 and 2) make sure add the +e766 options, this warning is about: unused header files. pclint/flint -vf ... This will cause pclint output included header files, nested header files will be indented appropriately.

我尝试过使用Flexelint (PC-Lint的unix版本)，结果有些复杂。这可能是因为我正在处理一个非常庞大且复杂的代码库。我建议仔细检查报告为未使用的每个文件。

主要的担忧是假阳性。同一报头的多个包含被报告为不需要的报头。这是很糟糕的，因为Flexelint没有告诉你头文件被包含在哪一行或者它之前被包含在哪里。

自动化工具可能会出错的一种方式是:

在A.hpp:

class A { 
  // ...
};

在B.hpp:

#include "A.hpp

class B {
    public:
        A foo;
};

在C.cpp:

#include "C.hpp"  

#include "B.hpp"  // <-- Unneeded, but lint reports it as needed
#include "A.hpp"  // <-- Needed, but lint reports it as unneeded

如果你盲目地跟随Flexelint的消息，你会把#include依赖项搞砸。有更多的病理情况，但基本上你需要自己检查标题，以获得最好的结果。

我强烈推荐这篇来自博客Games的关于物理结构和c++的文章。他们推荐了一个全面的方法来清理#include混乱:

的指导方针 以下是从Lakos的书中提炼出来的一组指导原则，可以最大限度地减少文件之间的物理依赖关系。我已经使用它们很多年了，我对效果一直很满意。 每个cpp文件首先包含它自己的头文件。(剪) 头文件必须包含解析它所需的所有头文件。(剪) 头文件应该有最少的头文件来解析它。(剪)

这不是自动的，但是doxygen会为#included文件生成依赖关系图。你必须从视觉上看它们，但它们对于了解什么在使用什么是非常有用的。

本文解释了一种使用Doxygen解析来删除#include的技术。这只是一个perl脚本，所以它很容易使用。

有一个免费的工具包括文件依赖监视器，它可以集成到可视化工作室中。它用红色显示多余的#include。