Doxygen无法识别C++模板继承，如何手动指定父类？

我之前也踩过Doxygen处理模板递归、偏特化继承的坑——明明代码里是用Implements<MySuper>这样的封装类做继承，结果文档里全是Implements展开后的复杂层级，完全看不到我们想展示的MyClass和MySuper的直接关系！下面分享几个亲测有效的解决方法：

方法1：用\cond隐藏实际继承结构，配合\extends指定父类 #

这是最直接的方案，让Doxygen完全忽略代码里的真实继承链，只显示你手动指定的父类关系：

//! \cond DOXYGEN_HIDE_INHERITANCE
// 把实际的继承代码放在cond块里，Doxygen会跳过解析
class MyClass : Implements<MySuper>
//! \endcond
//! \extends MySuper  // 手动指定MyClass的父类为MySuper
//! \brief 这里是MyClass的类描述
{
    // 类成员定义
};

• 注意\cond后面的标签可以自定义（比如DOXYGEN_HIDE_INHERITANCE），只要确保\endcond和它对应就行。
• 这个方法对模板递归、偏特化场景尤其有效，因为它直接屏蔽了Doxygen对复杂模板继承的解析。

方法2：用\class手动声明类的继承关系 #

如果不想完全隐藏代码里的继承结构，只是想让文档优先展示你指定的父类，可以在类的注释里用\class命令手动声明：

//! \class MyClass MyClass.h
//! \extends MySuper
//! \details MyClass实际继承自Implements<MySuper>，但逻辑上直接继承MySuper
class MyClass : Implements<MySuper> {
    // 类成员定义
};

这种方式下，Doxygen还是会解析Implements<MySuper>的继承链，但在类的文档首页会优先显示\extends指定的MySuper作为父类，同时你可以在\details里说明实际的实现细节。

方法3：调整Doxygen配置辅助优化 #

如果上面的方法还不够，你可以修改Doxyfile里的几个配置项：

• 关闭TEMPLATE_RELATIONS = NO：这样Doxygen不会自动生成模板类的继承关系图，减少冗余信息。
• 设置EXTRACT_PRIVATE = NO：如果Implements类里有私有继承的成员，关闭这个选项可以避免Doxygen展示不必要的层级。

注意事项 #

• 确保你的Doxygen版本是1.8.17及以上，旧版本对\extends和\cond的支持可能有bug。
• 如果MySuper本身也是模板类，记得在\extends里加上模板参数，比如\extends MySuper<int>。

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