CMake子目录配置报错：无法为非本项目构建的目标指定源文件

报错核心原因 #

• 你指定的最低CMake版本为3.9.1，该版本不支持跨目录修改非当前目录创建的目标（该限制在CMake 3.13版本才解除）。你在ComponentA、ComponentB子目录的CMake脚本中，调用target_sources、target_include_directories修改父目录src下创建的MyProject可执行目标，直接触发"目标不属于当前项目构建"的报错。
• 配置存在变量误用：CMAKE_ROOT_DIR是CMake自身的安装根目录（比如系统中CMake程序的安装路径），不是你的项目根目录，原配置会尝试把编译产物输出到CMake安装目录下的bin文件夹，普通用户无写入权限。
• 源文件名不匹配：ComponentA目录下的源文件为ObjectA.cpp，原配置中写的是不存在的ComponentA.cpp，就算解决目标作用域问题也会触发源文件找不到的错误。
• 头文件包含路径未按需求配置：原配置没有添加对应搜索路径，无法满足你两种场景的头文件引入需求。

适配需求的正确配置 #

采用组件编译为静态库再链接到主程序的方案，兼容CMake 3.9.1版本，完全匹配你的目录结构和头文件引入需求，不需要调整你写的C++引入代码。

1. 根目录 MyProject/CMakeLists.txt #

cmake_minimum_required(VERSION 3.9.1)
project(MyProject CXX)
# 按需配置C++版本，示例用C++17
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# 配置可执行文件输出路径为项目根目录下的bin文件夹
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/bin)
# 将src目录加入全局头文件搜索路径，满足main.cpp中#include <ComponentB/ObjectB.h>的引入需求
include_directories(${PROJECT_SOURCE_DIR}/src)
add_subdirectory(src)

2. src目录 MyProject/src/CMakeLists.txt #

# 先加载子组件配置
add_subdirectory(ComponentA)
add_subdirectory(ComponentB)
# 创建主可执行目标
add_executable(MyProject main.cpp)
# 链接两个组件的静态库
target_link_libraries(MyProject PRIVATE ComponentA ComponentB)

3. ComponentA目录 MyProject/src/ComponentA/CMakeLists.txt #

# 将ComponentA编译为静态库
add_library(ComponentA STATIC ObjectA.cpp)
# 将当前组件目录加入头文件搜索路径，满足组件内部#include <ObjectA.h>（或你命名的ComponentA.h）的引入需求
# PUBLIC属性会自动把该搜索路径传递给依赖ComponentA的其他目标
target_include_directories(ComponentA PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

4. ComponentB目录 MyProject/src/ComponentB/CMakeLists.txt #

# 将ComponentB编译为静态库
add_library(ComponentB STATIC ObjectB.cpp)
# 加入当前组件目录的头文件搜索路径
target_include_directories(ComponentB PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
# 如果ComponentB依赖ComponentA，保留该行，会自动传递头文件、链接依赖
target_link_libraries(ComponentB PUBLIC ComponentA)

配置说明 #

• 头文件引入完全匹配需求：main.cpp中用#include <ComponentB/ObjectB.h>可直接找到对应头文件；组件内部源文件用#include <ComponentB.h>/#include <ObjectB.h>（和你实际头文件名一致即可）不需要加路径前缀，可直接引用。
• 无跨目录修改目标的问题：每个组件的构建目标（静态库）都在自身目录的CMake脚本中创建，不存在跨目录修改父目标的操作，兼容3.9.1版本CMake。
• 依赖关系清晰：如果组件之间有依赖，直接通过target_link_libraries配置即可，依赖的头文件路径会自动传递，不需要手动给主目标重复配置。

目录结构优化建议 #

• bin、build目录不需要手动提前创建，CMake执行配置、编译时会自动生成，建议将这两个目录加入版本控制忽略列表（如.gitignore），避免提交编译产物。
• 如果后续项目规模扩大，可以将头文件统一放到src/include目录下按组件分子目录，源文件保留在组件目录下，实现头源分离，结构更易维护；当前头源同目录的写法对于小型项目完全可用，没有强制修改的必要。
• 如果后续组件增多，可以把通用编译选项、警告配置抽成顶层公共配置，避免每个组件重复编写。

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