Doxygen @ref无法为同一文件中#define宏生成引用的问题

问题详情 #

• 在同一.h文件的函数参数注释中使用@ref引用ALLOCOPTION_FROM_ISR这类#define宏时，生成的文档里既没有对应的引用链接，连该文件内的宏定义也完全未在文档中显示
• 执行Doxygen编译时会抛出unknown define警告
• 后续在文件的无关位置添加额外注释后，问题自动消失，推测这是Doxygen的解析Bug

临时解决办法 #

如果遇到同类问题，可以尝试在文件的任意空白位置（比如文件末尾、宏定义附近）添加一个无意义的注释块，例如：

/**
 * 临时占位注释，触发Doxygen正确解析
 */

以此强制触发Doxygen重新识别文件内的宏定义和@ref引用

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