配置Clang辅助解析后，Doxygen调用图未识别宏展开的函数调用

环境与配置信息 #

• 系统：Oracle Linux 9（基于RedHat）
• Doxygen版本：1.13.2（源码编译，启用Clang支持）
  编译命令：

  cmake -Duse_libclang=ON -G "Unix Makefiles"  ... 
  

• Doxyfile关键配置：

  CLANG_ASSISTED_PARSING = YES
  ENABLE_PREPROCESSING   = YES
  MACRO_EXPANSION       = YES
  SKIP_FUNCTION_MACROS   = NO
  EXPAND_ONLY_PREDEF     = NO
  PREDEFINED             =
  HAVE_DOT               = YES
  

测试代码 #

void defg()        
{int i=10; i++;}

void xyz()
{defg();}

#define MYFUNC2() xyz()

int main()
{ MYFUNC2();}

问题现象 #

预期生成调用图：[main]->[xyz]->[defg]，但实际仅显示[xyz]->[defg]的调用关系，main的调用图无对外调用记录；宏MYFUNC2仅作为条目显示（值为xyz()）。预处理器输出显示宏已正确展开，但该结果未体现在最终调用图中。

解决方案 #

1. 确认Clang解析是否生效 #

运行Doxygen时添加-v参数，查看输出日志中是否存在Using libclang version X.X.X的记录，确认Clang辅助解析已启用。若未找到该日志，说明编译时未正确链接libclang，需重新编译：

# 安装依赖包
sudo dnf install clang-devel
# 清理旧构建并重新编译
rm -rf build && mkdir build && cd build
cmake -Duse_libclang=ON -G "Unix Makefiles" ../
make -j$(nproc)
sudo make install

2. 优化Doxyfile配置 #

添加或修改以下配置项，强化宏解析与调用图追踪：

# 指定代码标准，匹配你的项目
CLANG_OPTIONS = -std=c99
# 启用调用图与被调用图
CALL_GRAPH = YES
CALLER_GRAPH = YES
# 确保宏展开后的代码被用于调用分析
EXPAND_MACROS_IN_CODE = YES
# 保持原有宏解析配置
MACRO_EXPANSION = YES
SKIP_FUNCTION_MACROS = NO

3. 临时 workaround：调整宏定义格式 #

若配置调整无效，可尝试修改宏定义为带括号的形式（避免解析歧义）：

#define MYFUNC2() (xyz())

或直接将宏替换为静态内联函数（如果项目允许）：

static inline void MYFUNC2() { xyz(); }

4. 升级Doxygen版本 #

Doxygen 1.13.2存在部分Clang解析相关的已知问题，建议升级至最新稳定版（如1.10.x及以上），新版本对宏展开后的调用关系识别支持更完善。

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