如何让Doxygen在命名空间文档页列出所有命名空间成员

核心配置调整 #

打开你的Doxygen配置文件（默认文件名为Doxyfile），修改以下配置项即可：

• 将EXTRACT_NAMESPACE_MEMBERS设置为YES
  该配置专门控制命名空间级别的成员（自由函数、typedef、常量、枚举、变量等）是否被提取并聚合到命名空间详情页，是解决该问题的核心开关，1.8.12版本默认将该参数设为NO。
• 确认SHOW_NAMESPACES设置为YES
  该开关控制独立命名空间页面的生成，若设为NO只会在索引里出现命名空间名称，不会生成带成员列表的详情页。
• 确认OPTIMIZE_OUTPUT_FOR_C设置为NO，OPTIMIZE_OUTPUT_FOR_CPP设置为YES
  如果误开了C语言输出优化，Doxygen会忽略C++命名空间的成员聚合逻辑，导致成员只出现在所属文件页面。
• 若你没有给所有命名空间成员添加Doxygen注释，需要额外将EXTRACT_ALL设置为YES，否则未加文档注释的成员不会被提取展示。
• 跨文件定义命名空间成员的场景，需要将RECURSIVE设置为YES，且INPUT路径覆盖所有存放该命名空间代码的目录，FILE_PATTERNS包含你使用的C++文件后缀（.h/.hpp/.cpp/.cc等），避免漏扫文件。

子命名空间展示配置 #

• 若需要在父命名空间页面直接内嵌展示子命名空间的所有成员，将INLINE_NS_MEMBERS设置为YES
• 若仅需要在父命名空间页面保留子命名空间的跳转链接，保持INLINE_NS_MEMBERS为NO即可，两种模式都符合使用要求。

生效验证 #

修改配置后先删除旧的文档输出目录，避免缓存干扰，再执行doxygen 你的配置文件路径重新生成文档，打开对应命名空间页面即可看到所有归属的成员条目。

注意：1.8.12版本存在已知兼容问题，若命名空间存在匿名嵌套或者跨多磁盘路径定义，需要将FULL_PATH_NAMES设置为YES才能保证所有成员被正确聚合。

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