Doxygen中Span类基类未正常解析问题求助

1. 核对模板类继承的参数匹配 #

Doxygen对模板类的继承解析精度很高，务必确保Span类的模板参数与VctrBase完全一致：

• 检查Span的继承声明是否存在拼写错误，模板参数的数量、类型（包括typedef别名）要和基类严格匹配
• 若VctrBase带有默认模板参数，确认Span继承时要么显式指定参数，要么正确继承默认参数逻辑

2. 确认Span类文件被Doxygen正确扫描 #

• 查看Doxyfile的INPUT配置，保证包含Span类所在的头文件/源文件路径
• 查看GitHub Actions中的Doxygen运行日志，确认Span的文件被成功解析，没有出现类似warning: no matching class found for base class VctrBase的警告

3. 检查Span类的Doxygen注释完整性 #

• 确保Span类有完整的类级Doxygen注释（例如/** @class Span 动态视图容器类 */），缺失类注释可能导致Doxygen无法识别其继承关系
• 如果Span是通过using或typedef定义的模板别名，要确保别名也配有Doxygen注释，或者原始模板类的继承关系能被正确追踪

4. 排查模板特化的影响 #

如果Span存在模板特化或部分特化，Doxygen可能将特化版本视为独立类，破坏继承链解析：

• 检查Span的特化代码，确保特化版本同样显式继承了VctrBase
• 若使用部分特化，确认特化的参数范围没有导致继承关系被忽略

5. 验证环境与版本兼容性 #

• 在本地用相同版本的Doxygen（1.9.6）生成文档，排除GitHub Actions环境的特殊配置干扰
• 尝试升级到Doxygen最新稳定版（如1.10.x），部分模板继承的解析bug在新版本中已修复

6. 检查继承访问修饰符与配置 #

• 确认Span继承VctrBase的访问修饰符（public/protected/private）与Array、Vector完全一致，private继承的基类默认不会在继承图中完整展示
• 核对Doxyfile中的SHOW_PRIVATE_MEMBERS、SHOW_PROTECTED_MEMBERS配置，确保继承链中的类成员和关系能被正常显示

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