Doxygen 1.8.18嵌套结构体成员链接生成问题咨询

Doxygen 1.8.18支持嵌套结构体成员的链接功能，你的问题出在链接格式写法错误，以下是正确的解决方法：

正确的链接格式 #

对于嵌套层级的结构体成员，Doxygen要求使用::作为层级分隔符，而非.。你需要把链接写成：

#Struct1_ts::Struct2::var

而不是你尝试的#Struct1_ts.Struct2_ts.var或#Struct1_ts.Struct2.var。

为什么原写法无效 #

• 直接引用顶层结构体成员时（比如#Struct2_ts.var），.可以生效，因为这是Doxygen对顶层结构体成员的兼容写法；
• 但嵌套层级下，必须用::来明确区分结构体类型和成员的层级关系，Doxygen才能正确解析跳转路径。

可能影响链接的Doxyfile配置检查 #

如果使用正确格式后仍无法跳转，检查以下配置项：

• ENABLE_PREPROCESSING：确保设为YES，Doxygen需要预处理逻辑解析typedef定义的结构体别名；
• EXTRACT_ALL：如果设为NO，只有被Doxygen注释文档化的成员才会生成链接，需确保你的结构体和成员都带有/** ... */格式的注释；
• OPTIMIZE_OUTPUT_FOR_C：设为YES，优化C语言代码的解析逻辑，避免因语言特性导致的识别错误。

额外建议 #

给结构体和成员添加明确的Doxygen注释，能帮助工具更准确识别成员关系，示例如下：

/** 子结构体定义 */
typedef struct{
    /** 子结构体中的变量 */
    ui8 var;
} Struct2_ts;

/** 包含子结构体的父结构体 */
typedef struct{
    /** 父结构体中的子结构体实例 */
    Struct2_ts Struct2;
} Struct1_ts;

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