如何为Doxygen生成的C项目文档获取可引用静态URL

当然可以！Doxygen其实自带了配置项来解决这个问题，能让生成的HTML文档URL变成静态、易读的格式，完全符合你想要的struct_brp_card_families.html这种样式。

具体设置步骤 #

只需要修改你的Doxyfile配置文件中的几个关键参数：

• SHORT_NAMES = NO：这是最核心的设置！默认情况下Doxygen会开启SHORT_NAMES = YES，为了缩短文件名会自动添加随机哈希串。把它改成NO后，Doxygen就会使用完整的、基于实体名称的文件名，比如结构体就会生成struct_brp_card_families.html，函数会生成类似func_brp_card_init.html的静态URL。
• CREATE_SUBDIRS = NO（可选）：如果不希望Doxygen把不同类型的文档分到子目录里，可以开启这个设置，让所有HTML文件都放在同一个输出文件夹下，更方便外部链接定位。
• HTML_FILE_EXTENSION = .html：这个默认就是.html，一般不需要修改，确保生成的文件扩展名统一即可。

验证效果 #

修改完配置后，重新运行Doxygen生成文档，你会发现所有HTML文件的命名都变得清晰且静态，完全可以放心地从其他网页文档链接到这些固定的URL上，不用担心哈希串变化导致链接失效。

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