如何在CMake中引入头文件？头文件链接报错求助

问题根源 #

1. 无效的add_subdirectory(library/folder1/include)：该目录下的CMakeLists为空，完全不需要通过add_subdirectory引入，属于冗余配置。
2. include_directories路径逻辑错误：使用相对路径library/folder1/include时，CMake会基于构建目录而非源码目录查找，导致路径匹配失败。
3. 代码中头文件引用层级错误：已将library/folder1/include加入包含目录，却写#include "include/headerfile2.h"，多了一层include目录，与实际文件结构不匹配。

修正步骤 #

1. 清理冗余配置 #

• 删除根目录CMakeLists.txt中的add_subdirectory(library/folder1/include)行。
• 删除library/folder1/include目录下的空CMakeLists.txt文件。

2. 调整根目录CMakeLists.txt #

仅引入必要的子目录：

add_subdirectory(src)
add_subdirectory(library/folder1)

3. 配置library/folder1的CMakeLists.txt #

将该目录定义为仅头文件库（INTERFACE库），让src的目标能通过链接自动获取头文件路径：

add_library(folder1 INTERFACE)
target_include_directories(folder1 INTERFACE
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

4. 调整src目录的CMakeLists.txt #

用target_link_libraries替代include_directories，明确关联头文件库：

# 替换my_target为你实际的可执行文件/库名称
add_executable(my_target file.c)
# 链接头文件库，自动引入头文件路径
target_link_libraries(my_target PRIVATE folder1)

5. 修正代码中的头文件引用 #

在file.h中直接引用头文件名：

#include "headerfile2.h"
#include "headerfile1.h" // 按需添加

备选方案（不定义头文件库） #

若不想创建INTERFACE库，可直接在src的CMakeLists.txt中指定绝对包含路径：

add_executable(my_target file.c)
target_include_directories(my_target PRIVATE
    ${CMAKE_SOURCE_DIR}/library/folder1/include
)

代码中的头文件引用同样改为直接写文件名。

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