多目录CMake项目配置错误求助：源码与可执行文件分离结构

错误原因 #

src目录的CMakeLists.txt直接对main目标（该目标在test子目录中定义）执行target_include_directories、target_compile_definitions等操作，但跨子目录无法直接访问未在当前项目中构建的目标，因此触发报错。正确的做法是将src封装为库，通过库传递依赖配置，再让test的可执行文件链接该库。

修正后的各CMakeLists.txt内容 #

根目录 ./CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 按顺序处理子目录
add_subdirectory(src)
add_subdirectory(test)

src目录 ./src/CMakeLists.txt #

# 创建静态库，将src模块封装为可复用的库
add_library(my_lib STATIC)

# 向库添加关联文件（后续新增.c文件直接追加即可）
target_sources(my_lib PRIVATE file.h)

# 设置库的公开包含目录，依赖该库的目标自动继承此路径
target_include_directories(my_lib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

# 设置库的公开编译定义，依赖目标自动继承
target_compile_definitions(my_lib PUBLIC SOME_DEFINE=1)

# 若库需要链接外部库，可在此配置（示例）
# target_link_libraries(my_lib PUBLIC external_lib)

test目录 ./test/CMakeLists.txt #

# 生成可执行文件main
add_executable(main main.c)

# 链接src的静态库，自动继承库的包含目录、编译定义等配置
target_link_libraries(main PRIVATE my_lib)

# 指定可执行文件输出到build根目录（默认输出在build/test下，此为可选调整）
set_target_properties(main PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR})

关键CMake函数说明 #

根目录配置函数 #

• cmake_minimum_required(VERSION 3.10)：指定CMake最低支持版本，确保后续使用的函数语法兼容。
• project(MyProject)：定义项目名称，自动生成PROJECT_NAME等项目相关变量。
• add_subdirectory(src/test)：触发子目录的CMakeLists.txt解析，按顺序构建子模块。

src目录配置函数 #

• add_library(my_lib STATIC)：创建名为my_lib的静态库（替换为SHARED可生成动态库），将src模块的代码打包为可复用单元。
• target_sources(my_lib PRIVATE file.h)：向库添加关联文件，PRIVATE标识这些文件仅属于库内部，不对外暴露。
• target_include_directories(my_lib PUBLIC ...)：设置库的包含目录，PUBLIC表示该目录会被库自身和所有依赖它的目标共享，无需在test中重复配置。
• target_compile_definitions(my_lib PUBLIC ...)：设置编译宏定义，PUBLIC确保依赖该库的目标自动继承这些定义，实现统一配置。

test目录配置函数 #

• add_executable(main main.c)：基于main.c生成名为main的可执行文件。
• target_link_libraries(main PRIVATE my_lib)：将可执行文件与静态库链接，同时自动继承库的包含目录、编译定义等依赖配置。
• set_target_properties(...)：调整可执行文件的输出路径，CMAKE_BINARY_DIR指向build目录，确保生成的可执行文件直接存放在build根目录下。

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