如何让Doxygen仅显示循环头文件依赖？

Doxygen本身没有直接只展示循环依赖的开关，但可以通过以下两种方式精准定位/可视化循环头文件依赖：

方法一：用Doxygen警告信息直接定位循环 #

• 打开Doxygen GUI的警告标签页
• 找到并勾选WARN_ABOUT_CIRCULAR_INCLUDES选项（新版Doxygen一般放在警告分类下）
• 生成文档时，Doxygen会在警告输出窗口或生成的warning.log文件里，清晰列出所有循环依赖，比如提示warning: cycle detected in include graph: fileA.h -> fileB.h -> fileA.h
• 这种方式不用依赖GraphViz，直接通过文本警告就能快速找到所有循环

方法二：过滤GraphViz生成的依赖图 #

如果想可视化查看循环，可以按以下步骤操作：

• 保持之前的GraphViz相关选项勾选，正常生成完整的依赖图
• 找到Doxygen输出目录里的.dot格式文件（通常在html/_dot文件夹下，文件名对应具体头文件）
• 用文本编辑器打开.dot文件，手动删除非循环的依赖边；如果文件多，也可以写个简单脚本批量检测并保留循环相关的节点和边
• 用GraphViz的dot工具重新编译修改后的文件，生成只含循环的图：dot -Tpng 修改后的文件.dot -o 循环依赖图.png

额外小技巧 #

• 新版Doxygen（1.9及以上）可以在专家标签页里，把DOT_GRAPH_MAX_NODES设为较小值，配合循环警告，生成的图会自动聚焦在有循环的节点上，减少无关内容干扰

内容的提问来源于stack exchange，提问作者Marsupito