使用@copydoc复制枚举类文档时出现警告但HTML输出正常,是否有已知Bug?
Doxygen @copydoc 警告但输出正常的问题解析
问题本质
这是Doxygen 1.9.4版本的已知解析顺序Bug:
- 即便你已经设置
EXTRACT_PRIVATE=YES,Doxygen在解析@copydoc标签的早期阶段,尚未完成私有成员foo::Helper的索引构建,因此误报"目标未找到"的警告。 - 而在后续生成HTML输出的阶段,私有成员的索引已完成,所以能正确复制文档内容,最终输出表现正常。
解决方案
- 升级版本:该Bug在Doxygen 1.9.5及后续稳定版本中已被修复,升级到最新版即可彻底消除这个警告。
- 临时规避(不升级时):在
@copydoc中使用完整作用域路径xyz::foo::Helper,部分场景下可避免警告触发,但这只是临时方案,升级版本才是根本解决办法。
代码注意事项
你的示例代码中,第二个枚举类命名为foo与外层类名冲突,属于代码本身的问题,建议修改为其他名称(比如FooEnum),避免后续出现编译或文档生成的额外问题。
内容的提问来源于stack exchange,提问作者MKFein
相关产品推荐
相关产品推荐

