CMake多目录配置：子目录库链接后编译找不到头文件问题

核心问题点 #

• 你最开始写的配置逻辑本身是对的，符合现代CMake的目标属性传递规则，构建失败基本两个原因：一是改了好几次配置都没清build目录的缓存，旧配置残留导致不生效；二是如果enemy.h或者enemy.cpp里include了根目录的fighter.h，enemy目标本身没加根目录的头文件搜索路径，编译enemy.cpp阶段就会报错。
• 后来你参考视频添加的配置存在问题：target_link_directories是给外部预编译库加搜索路径用的，同一个项目里通过add_subdirectory引入的目标根本不需要这个配置，多余添加反而可能干扰路径解析；要是你改配置的时候把enemy子目录下原来写的target_include_directories(enemy PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})给删了，头文件路径自然传不到可执行文件目标上。
• 你一开始写的CMake最低版本要求3.0太老了，这套目标属性传递机制在老版本上存在兼容问题，建议最低升到3.10。

正确配置代码 #

子目录 enemy/CMakeLists.txt #

# 定义静态库目标，头文件加入源码列表仅用于IDE识别显示，不影响编译逻辑
add_library(enemy STATIC enemy.cpp enemy.h)
# 声明当前enemy目录为公共头文件路径，所有链接enemy的目标会自动继承该路径
target_include_directories(enemy PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
# 如果enemy模块代码需要引用根目录的fighter.h，添加根目录为私有头文件路径，不会传递给上层目标
target_include_directories(enemy PRIVATE ${CMAKE_SOURCE_DIR})

根目录 mainfolder/CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)
project(game)

# 必须先引入子目录，确保enemy目标被提前定义后再执行链接操作
add_subdirectory(enemy)

set(SOURCES
    main.cpp
    fighter.cpp
)
set(HEADERS
    fighter.h
)

add_executable(${PROJECT_NAME} ${SOURCES} ${HEADERS})
# 配置根目录为可执行文件的私有头文件路径，用于查找fighter.h
target_include_directories(${PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
# 链接enemy库，会自动继承enemy配置的PUBLIC头文件路径，无需额外单独配置enemy的include路径
target_link_libraries(${PROJECT_NAME} PRIVATE enemy)

注意事项 #

• 配置完成后main.cpp中直接写#include "enemy.h"即可正常编译，不需要写成#include "enemy/enemy.h"。
• 每次修改CMakeLists.txt后，必须完全清空build目录下的所有缓存文件，再重新执行cmake ..和编译命令，旧缓存不清理是新手配置CMake时最常见的配置不生效原因。
• 写CMake尽量使用target_include_directories、target_link_libraries这类目标级别的命令，通过PUBLIC/PRIVATE/INTERFACE控制属性传递范围，不要使用全局的include_directories、link_directories这类老命令，避免全项目路径污染。

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