为何Doxygen生成的命名空间列表中出现类名？

1. 是否为Doxygen有意设计？ #

不是。正常逻辑下，命名空间页面仅展示用户显式定义的命名空间节点，不会将类直接混入该页面列表。出现此现象属于解析或配置/注释异常，而非设计预期。

2. 如何避免及问题排查方向 #

• 检查类注释标签：确认是否误将@namespace标签添加到类的注释块中，或使用@ingroup时将类归入与命名空间同名的分组，导致Doxygen错误关联展示。
• 核对配置文件：
  • 查看EXTRACT_ALL是否设为YES：开启全提取后，Doxygen会解析所有符号，包括未正确关联命名空间的类，可能导致混入。
  • 检查SHOW_NAMESPACES、GROUP_NAMESPACES等命名空间相关配置，确认未开启强制合并类与命名空间展示的选项。
  • 排查FILE_PATTERNS、EXCLUDE_PATTERNS，确保未引入无关代码文件导致解析异常。
• 代码结构校验：检查是否存在类定义在命名空间外部，但通过using/typedef将其导入命名空间的情况；或类的命名空间归属注释缺失，导致Doxygen无法正确识别其所属命名空间。
• 版本兼容性验证：你使用的是master分支的开发版（v1.11.0），可能存在未修复的解析bug。可切换至稳定版v1.10.0重新生成文档，排查是否为版本问题。

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