Doxygen无法为条件宏包裹的C函数生成call(er)调用图问题求助

问题原因 #

这是Doxygen的已知行为/低版本缺陷，根源是预处理器输出校验和调用图解析是两个独立的执行流程：
预处理器阶段确实能正确展开条件块得到完整的函数定义，但调用图生成模块在执行前会额外检查函数的外层语法结构，一旦检测到函数定义被#if/#endif条件编译块包裹，默认会跳过该函数的内部调用语句扫描流程，因此无法生成调用图。

解决方案 #

你可以按照以下优先级尝试修复：

• 首先调整Doxygen配置项，修改/新增以下标签：
  • 将EXPAND_ONLY_PREDEF改为NO，让Doxygen预处理器展开所有可识别的宏，而非仅展开预定义列表内的宏，避免条件块标记残留
  • 预定义列表补充TRUE=1，确保条件判断的所有常量都被预处理器明确识别：PREDEFINED = X=TRUE TRUE=1
  • 新增SKIP_FUNCTION_MACROS = NO，避免宏包裹的函数逻辑被解析流程跳过
• 如果调整配置后仍未生效，可以在条件包裹的函数块前后添加Doxygen专用的条件解析标记，显式告知Doxygen该块需要完整解析：

  /** @cond X_ENABLED */
  #if (defined (X) && (TRUE == X))
  void TestFunction()
  {
    TestedFunction();
  }
  #endif
  /** @endcond */
  

  同时在配置的ENABLED_SECTIONS中添加X_ENABLED，让Doxygen明确标记该块为启用状态，不会跳过内部的调用关系解析。
• 如果你使用的是1.8.17及更早版本的Doxygen，建议升级到1.9.x以上正式版本，该版本已修复了条件编译块包裹函数的调用图生成缺陷。

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