如何在Doxygen项目中自动生成自定义.h文件索引（补充默认索引）

当然有办法自动实现这个需求！Doxygen本身提供了灵活的配置和命令来生成额外的专属索引，下面是两个最省心的自动方案：

方案一：自定义Markdown页面+文件筛选命令 #

这个方法不需要修改现有代码，只需要添加一个自定义文档页面，利用Doxygen的内置命令自动筛选并列出所有头文件：

1. 在项目根目录创建一个名为headers_index.md的Markdown文件，内容如下：

# 头文件专属索引

下面是项目中所有头文件的列表，点击文件名可直接查看对应文档：

\filter{*.h}
\filelist
\endfilter

2. 打开你的Doxygen配置文件（通常是Doxyfile），做两个修改：
   • 确保MARKDOWN_SUPPORT设置为YES（默认已经开启）
   • 将headers_index.md添加到INPUT配置项中，比如：

     INPUT = src/ headers_index.md
     

3. 重新运行Doxygen，生成的文档中就会多出一个名为“头文件专属索引”的页面，里面只包含所有.h文件的列表和链接。

方案二：修改布局文件添加独立索引导航 #

如果你希望这个专属索引出现在导航栏里，和默认索引并列，可以通过修改Doxygen的布局文件来实现：

1. 首先导出Doxygen的默认布局文件，运行命令：

   doxygen -l
   

   这会生成一个DoxygenLayout.xml文件。
2. 打开DoxygenLayout.xml，找到<navindex>节点（这是导航栏的配置部分），在合适的位置添加一个新的导航项，指向筛选后的头文件列表：

   <navindex>
     <!-- 保留原有导航项，比如<tab type="mainpage" ... /> -->
     <tab type="user" url="headers_index.html" title="头文件索引">
       <tab type="list" url="headers_index.html" title="所有头文件"/>
     </tab>
   </navindex>
   

3. 按照方案一的步骤创建headers_index.md，然后在Doxyfile中设置LAYOUT_FILE = DoxygenLayout.xml，指定使用自定义布局。
4. 重新运行Doxygen，导航栏就会多出一个“头文件索引”的选项，点击直接进入专属的头文件列表页面。

额外技巧：精准筛选特定目录的头文件 #

如果你的项目中头文件分布在不同目录，只想索引某几个目录下的.h文件，可以在headers_index.md里结合\dir命令和筛选：

# 核心模块头文件索引

\filter{*.h}
\dir src/core/
\endfilter

这样页面就只会列出src/core/目录下的所有头文件。

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