如何让头文件的预处理语句根据包含它的C++源文件动态适配

实现步骤 #

1. 在需要特殊处理的.cpp文件中定义专属标识宏
   在包含目标头文件前，为需要触发特殊引入逻辑的源文件定义唯一的预处理器宏，无需特殊处理的源文件直接包含头文件即可。
   示例代码：
   main.cpp：

   // 包含header.h前先定义标识宏
   #define INCLUDE_FROM_MAIN
   #include "header.h"
   

   other.cpp：

   // 无需定义特殊宏，直接引入
   #include "header.h"
   

2. 在header.h中添加预编译条件判断
   用预处理器的条件判断指令检测宏是否存在，决定是否引入指定依赖头文件。
   示例代码：
   header.h：

   // 常规头文件保护
   #ifndef HEADER_H
   #define HEADER_H
   
   // 仅被main.cpp包含时才引入指定头文件
   #ifdef INCLUDE_FROM_MAIN
   #include "some_file_which_fails_when_used_with_OTHER_CPP.h"
   #endif
   
   // 头文件原有其他逻辑
   // ...
   
   #endif // HEADER_H
   

注意事项 #

不推荐通过判断__FILE__宏的方式实现该需求：__FILE__是预处理器展开的字符串字面量，标准C++的预编译条件指令不支持字符串比较，且不同编译器、不同编译参数下__FILE__返回的路径格式（绝对/相对）可能不同，兼容性差。

• 标识宏的命名尽量唯一，建议加上项目、模块相关前缀，避免和项目中其他宏冲突
• 如果有多个源文件需要对应不同的分支逻辑，可以为每个源文件定义不同的标识宏，在头文件中做多分支判断即可
• 必须保证标识宏的定义写在包含头文件的代码之前，否则判断逻辑会失效

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