Doxygen 1.9.3：外部.tags文件中的未文档化命名空间显示在命名空间索引中的问题咨询

你遇到的这个情况其实是Doxygen的默认行为——当引入外部标签文件时，它会把标签里包含的命名空间也一并展示在你的文档命名空间列表里，确实容易让用户误以为这些是你的库的一部分，不过咱们可以通过配置快速解决。

最直接的解决方案：用EXCLUDE_SYMBOLS过滤外部命名空间 #

在你的Doxyfile里添加EXCLUDE_SYMBOLS配置项，明确排除Qt相关的所有命名空间：

EXCLUDE_SYMBOLS = Qt* \
                   Q*

这个配置会把所有以Qt或Q开头的外部命名空间从你的命名空间视图里移除，但完全不影响文档中对Qt类/函数的链接能力——只要你的代码里引用了Qt的成员，Doxygen依然会通过标签文件生成正确的外部跳转链接。

为什么这个方案可行？ #

Doxygen的EXCLUDE_SYMBOLS是用来过滤不需要出现在文档中的符号，它只会隐藏这些命名空间的展示，不会切断标签文件的链接关联，刚好匹配你“隐藏外部命名空间但保留链接”的需求。

操作步骤提醒 #

1. 在你的CMake生成的Doxyfile中添加上述EXCLUDE_SYMBOLS配置
2. 清理之前的文档输出目录（避免缓存影响）
3. 重新运行Doxygen生成文档，此时命名空间视图里应该就只剩下你的Qx命名空间了

关于你提到的Bug疑问 #

你怀疑是#5258问题的回归，不过从当前情况看，这更像是Doxygen默认行为导致的，而非Bug。用EXCLUDE_SYMBOLS就能完美解决，不需要等待官方修复。

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