如何在C项目文件中导入XXX.h.in头文件？CMake预处理须知

首先明确：你不能直接在.c文件中导入XXX.h.in——它是CMake专用的配置模板文件，不是可直接被编译器识别的标准头文件，必须先通过CMake处理生成实际的.h文件后才能使用。

必须的CMake处理步骤 #

1. 用configure_file()生成实际头文件
   在项目的CMakeLists.txt中添加以下命令，将模板文件转换为可编译的头文件：

   # 把当前目录下的XXX.h.in模板，生成到构建目录下的XXX.h
   configure_file(XXX.h.in XXX.h @ONLY)
   

   其中@ONLY参数表示仅替换模板中以@变量名@格式标记的内容，避免和CMake自身的${变量名}语法冲突。

2. 让编译器找到生成的头文件
   生成的XXX.h会放在CMake的构建目录（而非源码目录）中，需要通过target_include_directories()告诉编译器这个路径：

   # 假设你的目标可执行/库名为your_target
   target_include_directories(your_target PRIVATE ${CMAKE_CURRENT_BINARY_DIR})
   

在.c文件中导入头文件 #

完成上述CMake配置并执行构建后，直接在.c文件中导入生成后的XXX.h即可：

#include "XXX.h"

额外说明 #

• XXX.h.in模板中可以包含CMake变量占位符，比如@PROJECT_VERSION@、@CMAKE_INSTALL_PREFIX@，CMake处理时会自动将这些占位符替换为项目构建时的实际值。
• 如果你的项目不使用CMake构建，那么XXX.h.in模板对你没有直接作用，需要手动替换模板中的占位符，生成普通的.h文件后再导入使用。

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