如何从一个生成器函数中使用 @copydoc

编程语言 2026-07-09

我有一个函数 testFixture,其中包含大量Doxygen注释。这个函数在一个测试函数 testA 中被调用,并且该测试函数会产生 testFixture

应用 @copydoc testFixture 或其完全限定版本似乎不起作用。不过,如果把它应用到任何不会产生它的其他函数上,拷贝就能正常完成。

查看XML的时候,似乎Doxygen为 testFixture(来自yield语句)同时创建了函数条目和变量条目,但总是解析到空的变量条目,而不是文档化的函数条目。

有解决办法吗?

解决方案

你可以通过提供完整的函数签名(包括括号),而不是仅写函数名,来强制 @copydoc忽略变量条目。这样可以明确告诉Doxygen你指向的是一个函数

不是这个:

## @copydoc testFixture

把它改成这个:

## @copydoc testFixture()

站内所有文章版权归属LeftHeroAI导航站,无授权禁止任何主体转载、抄袭、复制内容,亦不得私自架设镜像站点。一经侵权,本站将通过法律途径追责。

相关文章