如何修改CMakeLists.txt使接口库优先引入指定头文件？

问题根源在于：prod.h位于inc目录下，当它通过#include "platform.h"引入头文件时，编译器会优先搜索当前源文件所在的inc目录，找到同名的platform.h，从而无法使用platform2目录下的版本。以下是两种仅修改CMakeLists.txt的解决方法：

方案一：GCC专属 - 禁用当前目录优先搜索 #

通过GCC编译选项改变头文件搜索行为，让编译器不再优先查找当前源文件目录：

cmake_minimum_required(VERSION 3.27)
project(interface_lib_test)

add_library(interface_lib_test INTERFACE)
# 直接设置接口库的包含目录，替代原FILE_SET写法
target_include_directories(interface_lib_test INTERFACE inc)

add_library(platform2 INTERFACE)
target_include_directories(platform2 INTERFACE platform2)

add_executable(exe1 src/main.c)
# 调整链接顺序，确保platform2的包含目录被优先添加
target_link_libraries(exe1 platform2 interface_lib_test)
# 禁用#include "..."的当前目录优先搜索
target_compile_options(exe1 PRIVATE -fno-working-directory)

原理 #

-fno-working-directory会让GCC处理#include "..."时，跳过当前源文件目录的搜索，直接按照INCLUDE_DIRECTORIES的顺序查找。结合链接顺序调整，platform2的目录会排在inc前面，从而优先找到目标头文件。

方案二：跨平台通用 - 分离prod.h与同名头文件 #

将prod.h复制到构建目录的独立目录，避免与inc/platform.h同目录，让编译器按包含目录顺序搜索：

cmake_minimum_required(VERSION 3.27)
project(interface_lib_test)

# 在构建目录下创建独立的include目录
set(BUILD_INCLUDE_DIR ${CMAKE_BINARY_DIR}/include)
file(MAKE_DIRECTORY ${BUILD_INCLUDE_DIR})
# 复制prod.h到新目录，脱离原inc目录的同名文件影响
file(COPY inc/prod.h DESTINATION ${BUILD_INCLUDE_DIR})

add_library(interface_lib_test INTERFACE)
# 使用构建目录的include目录替代原inc目录
target_include_directories(interface_lib_test INTERFACE ${BUILD_INCLUDE_DIR})

add_library(platform2 INTERFACE)
target_include_directories(platform2 INTERFACE platform2)

add_executable(exe1 src/main.c)
# 确保platform2的包含目录优先被搜索
target_link_libraries(exe1 platform2 interface_lib_test)

原理 #

通过复制prod.h到无同名platform.h的目录，编译器处理prod.h中的#include "platform.h"时，会直接遍历INCLUDE_DIRECTORIES中的目录，优先找到platform2下的版本。该方法不依赖特定编译器，跨平台通用。

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