CMake项目构建报错：无法为未构建的target 'hello'指定包含目录

报错的核心原因是调用target_include_directories时，目标hello还未被创建。CMake要求所有针对目标的操作（如设置包含目录、链接库）必须在目标被add_executable或add_library定义之后执行。

根目录 CMakeLists.txt #

原代码基本可用，补充注释增强可读性：

cmake_minimum_required(VERSION 3.16)
project(hello VERSION 1.0)

# 设置C++标准，放在project后更规范
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 进入src子目录处理源码
add_subdirectory(src)

src/CMakeLists.txt #

调整命令顺序，先创建目标再执行后续target操作：

# 先添加util子库
add_subdirectory(util)

# 必须先创建hello可执行目标，再执行target相关配置
add_executable(hello main.cpp)

# 设置hello的头文件搜索目录，PUBLIC表示依赖hello的目标也能继承该目录
target_include_directories(hello PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)

# 链接util静态库到hello
target_link_libraries(hello PUBLIC util)

src/util/CMakeLists.txt #

补充头文件目录设置，确保util库自身及依赖它的目标能找到头文件：

# 创建util静态库
add_library(util STATIC util.cpp)

# 设置util的头文件搜索目录，PUBLIC暴露给上层依赖目标
target_include_directories(util PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/../include)

1. 命令顺序：CMake的目标操作严格依赖目标存在，必须先通过add_executable/add_library定义目标，再调用target_*系列命令。
2. 头文件目录传递：使用PUBLIC关键字可让依赖目标（如hello依赖util）自动继承头文件搜索路径，避免重复配置。
3. 路径变量：CMAKE_CURRENT_SOURCE_DIR指向当前CMakeLists.txt所在目录，用它拼接路径可保证跨平台兼容性。

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