如何使Doxygen正确解析函数、结构体的__attribute__属性？

你定义的带__attribute__((__weak__))的函数在Doxygen中无法被正确解析，核心原因是默认情况下Doxygen对GCC风格的属性语法支持有限，可通过以下几种方式解决：

方法一：修改Doxygen配置文件（Doxyfile） #

在配置文件中找到PREDEFINED配置项，添加对__attribute__的宏定义，让Doxygen将这类属性语法视为空内容，避免干扰函数原型的解析：

PREDEFINED = __attribute__(x)=

如果只想针对__weak__属性做处理，也可以更精准地定义：

PREDEFINED = __attribute__((__weak__))=

方法二：用\fn命令显式声明函数 #

在函数的Doxygen注释中，通过\fn命令明确指定完整的函数原型，强制Doxygen识别函数信息，不受属性语法影响。调整后的代码示例：

/**
 * @brief   获取操作系统当前时间节拍。
 *          这是一个弱函数，旨在被重写。
 * @return  弱版本始终返回0；其他实现应返回当前OS时间节拍。
 * @fn      osalUint_t osal_tickGetCurrent(void)
 */
__attribute__((__weak__)) osalUint_t osal_tickGetCurrent(void)
{
    return 0;
}

方法三：开启宏展开功能 #

在Doxyfile中开启MACRO_EXPANSION并配合EXPAND_ONLY_PREDEF选项，让Doxygen展开预定义的宏（包括我们设置的__attribute__相关定义），确保函数原型被正确识别：

MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES

内容的提问来源于stack exchange，提问作者Łukasz Przeniosło