CMake项目中如何让所有子目录源文件找到指定头文件？

问题解决思路 #

你遇到的头文件找不到问题，核心是要让所有子目录的源文件都能访问指定目录的头文件，有两种可行方案，优先推荐现代CMake的目标绑定方式：

方案一：目标绑定式全局配置（推荐） #

放弃传统的include_directories，改用target_include_directories给Drawbox库目标设置公共包含目录，这样所有属于该目标的源文件都会自动继承这些路径，不需要在子目录里额外配置。

修改顶层CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.28)
project(my-project)

find_package(SDL2 REQUIRED)

add_library(Drawbox STATIC)

# 将需要的包含目录设为PUBLIC，确保目标自身及依赖它的模块都能访问
target_include_directories(Drawbox
    PUBLIC
        ${SDL2_INCLUDE_DIRS}
        .
        Library
        APClass
        Library/jpeg
)

add_subdirectory(Library)
add_subdirectory(Tools)
add_subdirectory(APClass)

target_compile_features(Drawbox PUBLIC cxx_std_11)

方案二：传统全局包含（不推荐） #

如果要沿用include_directories，只需把这条命令移到add_subdirectory之前，这样所有子目录的CMake配置都会继承这个全局包含路径：

cmake_minimum_required(VERSION 3.28)
project(my-project)

find_package(SDL2 REQUIRED)
link_directories(${SDL2_LIBRARY_DIRS})

# 提前设置全局包含目录，确保子目录继承
include_directories(${SDL2_INCLUDE_DIRS} . Library APClass Library/jpeg)

add_library(Drawbox STATIC)

add_subdirectory(Library)
add_subdirectory(Tools)
add_subdirectory(APClass)

target_compile_features(Drawbox PUBLIC cxx_std_11)

这种方式的缺点是会污染所有后续创建的CMake目标，不如目标绑定方式精准可控。

原配置失效的可能原因 #

你之前的include_directories放在add_library之后、add_subdirectory之前，理论上子目录应该能继承，但可能受CMake作用域或子目录内其他配置影响。而target_include_directories直接绑定到目标，不受这些因素干扰，可靠性更高。

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