如何使用GCC仅处理#ifdef条件编译 不展开#include与宏定义

问题背景 #

对头文件做预处理时，仅需要裁剪#ifdef、#if defined类条件编译的无效分支，其余内容（包括#include指令、普通宏定义）全部保留原文不展开、不校验，输出结果供cmock类工具生成mock文件使用。
直接使用gcc -E做预处理时，会默认展开所有#include引入的头文件内容、完成全量宏替换，无法满足上述需求。

可用实现方案 #

GCC环境 #

使用GCC预处理的专属参数组合即可实现需求，命令格式如下：

gcc -E -fdirectives-only -P <输入头文件路径> -o <预处理后输出文件路径>

参数说明：

• -E：指定编译器执行预处理流程后停止
• -fdirectives-only：核心控制参数，开启后预处理阶段仅处理条件编译指令的分支裁剪，不会展开#include引入的外部内容，也不会对代码中的普通宏做替换，所有非条件编译类的预处理指令、代码原文都会原样保留
• -P：屏蔽预处理默认输出的#line行号调试标记，避免多余内容干扰cmock的解析逻辑

如果条件编译分支判断依赖预先定义的宏（比如编译配置开关、架构标识宏），直接在命令中通过-D宏名的方式传入即可，例如需要定义__MACRO_A__时，命令调整为：

gcc -E -fdirectives-only -P -D__MACRO_A__ test.h -o test_preprocessed.h

针对给出的示例代码，未定义__MACRO_A__时执行上述命令，输出结果完全符合预期：

#include <stdint.h>   // 不希望预处理该行


    void funcB(void);

Clang环境 #

如果使用Clang编译器，替换为对应参数即可，命令格式如下：

clang -E -frewrite-includes -P <输入头文件路径> -o <预处理后输出文件路径>

效果和GCC方案一致，仅处理条件编译分支，保留其余所有原始内容。

注意事项 #

• 执行命令时不要额外添加-include类引入外部头文件的参数，避免无关内容注入输出文件
• 如果存在嵌套的条件编译判断，该参数组合会递归处理所有层级的条件分支，不需要额外做特殊配置

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