如何在Doxygen 1.9.0中排除仅含前向声明的空命名空间

Doxygen 1.9.0 已经支持通过配置项解决仅含前向声明的空命名空间页面问题，无需依赖旧版本的hack方案，具体有两种可行配置：

方法一：直接排除目标命名空间 #

在你的Doxygen配置文件（Doxyfile）中添加以下配置，直接指定要排除的命名空间：

EXCLUDE_SYMBOLS = A

这个配置会完全移除命名空间A的独立文档页面，但不会影响类Y中对A::X*参数的引用显示，文档里仍能正常看到Y构造函数的参数类型。

方法二：自动隐藏无文档的命名空间 #

如果希望更灵活地控制（比如后续命名空间A添加了文档内容时自动显示），可以启用HIDE_UNDOC_NAMESPACES配置：

HIDE_UNDOC_NAMESPACES = YES

开启后，Doxygen会自动隐藏所有没有文档注释的命名空间。由于你的namespace A仅包含前向声明且无任何文档注释，它的空页面就不会被生成。

这两种配置在Doxygen 1.9.0版本中都能生效，完美解决你遇到的问题。

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