Doxygen未生成C#继承模板类文档的问题求助

我之前也遇到过这种同名模板类重载的文档生成坑，Doxygen对这类特殊的模板结构有时候会识别不全，下面是几个亲测有效的排查和解决方法：

1. 检查Doxygen核心配置项 #

首先确认你的Doxyfile里的关键配置是否开启，这些是模板类重载识别的基础：

• 确保ENABLE_PREPROCESSING = YES（默认开启，但建议再核对）
• 开启TEMPLATE_RELATIONS = YES，这个选项会强制Doxygen解析模板类的继承关系和重载差异
• 如果你的类不是完全公开的接口，建议打开EXTRACT_ALL = YES，避免Doxygen忽略它认为“非公开”的模板重载类

2. 用@class指令明确区分两个类 #

Doxygen很容易把同名但参数不同的模板类混淆，你可以在三重斜杠注释里用@class指定完整的模板签名，帮它精准识别：

/// @class RoutingPair<R>
/// 基础路由配对类，处理单一接口逻辑
template <typename R>
class RoutingPair {
    // 类实现
};

/// @class RoutingPair<R, S>
/// 扩展路由配对类，继承基础类并支持监听第二接口
template <typename R, typename S>
class RoutingPair : public RoutingPair<R> {
    // 扩展实现
};

通过显式标注完整的模板参数列表，Doxygen就不会把这两个类当成同一个实体处理了。

3. 规范注释与类定义的位置 #

确保三重斜杠注释直接紧贴类的定义，中间不要插入空行或其他代码，否则Doxygen可能无法关联注释和类：

// 错误示例：注释和类之间有空行
/// 扩展类注释
template <typename R, typename S>
class RoutingPair : public RoutingPair<R> {
};

// 正确示例：注释直接在类定义上方
/// @class RoutingPair<R, S>
/// 扩展监听另一接口的继承类
template <typename R, typename S>
class RoutingPair : public RoutingPair<R> {
};

4. 清理缓存后重新生成 #

有时候Doxygen的临时缓存文件会导致解析异常，你可以删除生成的html、xml输出目录，以及根目录下的doxygen_objdb_*.tmp临时文件，然后重新运行Doxygen生成文档。

按上面的步骤调整后，Doxygen应该就能正确识别并生成两个RoutingPair类的文档了。

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