CMake add_executable内部机制及依赖处理问题咨询

首先得给你掰正一个关键误解：CMake 根本不会帮你自动推导可执行文件的最小源依赖集合。当你调用 add_executable(name ${SOURCES}) 时，它只会严格编译你传进去的所有源文件——不管这些文件里的代码有没有被 main 或者其他入口函数用到。CMake 是构建系统，不是代码分析工具，它没能力也不负责解析代码里的调用关系，这点得先搞清楚。

这是业内最主流的做法，既能保留自动源/测试发现的便利，又能解决你遇到的「编译冗余」「部分失败影响全局」的问题，具体步骤如下：

1. 把业务代码封装成库，而非直接塞进可执行文件 #

把 src 目录下的所有代码打包成静态库（或 OBJECT 库），这样业务代码只需要编译一次，所有测试和主程序都能复用编译结果：

# 自动收集src下的所有C源文件（CMake 3.12+推荐用CONFIGURE_DEPENDS，能自动检测文件增减）
file(GLOB_RECURSE PROJECT_SRC CONFIGURE_DEPENDS
    src/*.c
    src/*.h
)

# 最常用的方案：静态库
add_library(project_lib STATIC ${PROJECT_SRC})
# 给库设置头文件搜索路径，这样测试代码可以直接include业务头文件
target_include_directories(project_lib PUBLIC src)

# 进阶方案：OBJECT库（CMake 3.9+支持，适合需要精细控制目标文件的场景）
# add_library(project_objects OBJECT ${PROJECT_SRC})
# target_include_directories(project_objects PUBLIC src)

2. 为每个单元测试单独创建目标，仅链接需要的库 #

每个测试只需要包含自己的测试代码，然后链接业务库就行——这样编译测试时，只会编译测试文件本身，复用之前编译好的库文件，不会再重新编译整个 src 目录：

# 自动收集所有测试文件
file(GLOB_RECURSE TEST_SOURCES CONFIGURE_DEPENDS tests/*.c)

# 遍历每个测试文件，创建单独的测试目标
foreach(TEST_FILE ${TEST_SOURCES})
    # 提取测试文件名作为目标名（比如tests/this_unit_test.c → this_unit_test）
    get_filename_component(TEST_NAME ${TEST_FILE} NAME_WE)
    add_executable(${TEST_NAME} ${TEST_FILE})
    # 链接业务库
    target_link_libraries(${TEST_NAME} PRIVATE project_lib)
    # 把测试加入CTest（可选，方便批量运行所有测试）
    add_test(NAME ${TEST_NAME} COMMAND ${TEST_NAME})
endforeach()

如果你的项目规模较大，还可以把业务代码拆成更小的模块库（比如按功能拆成 utils_lib、core_lib），每个测试只链接它实际用到的模块：

# 拆分模块示例
add_library(utils_lib STATIC src/utils/*.c)
add_library(core_lib STATIC src/core/*.c)
# core模块依赖utils，所以链接utils库
target_link_libraries(core_lib PRIVATE utils_lib)

# 测试如果只用到utils，就只链接utils_lib
add_executable(utils_test tests/utils_test.c)
target_link_libraries(utils_test PRIVATE utils_lib)

这样一来，即使某个模块编译失败，其他模块的测试依然可以正常编译运行。

3. 关于「自动提取最小依赖子集」的说明 #

你问有没有CMake函数能返回main间接包含的源文件子集——答案是真没有。原因很直白：

• CMake在生成构建脚本的时候，还没开始编译代码，根本没法解析代码里的include和调用关系
• 就算编译器能生成头文件依赖（比如gcc -M），也只能知道头文件的依赖，没法判断哪个.c文件的符号被实际用到（这是链接器的工作，链接器会剔除未使用的符号，但CMake在编译阶段必须明确知道要编译哪些.c文件）

• 尽量避免全局源文件收集：虽然file(GLOB_RECURSE)很方便，但大型项目更推荐按模块手动维护源文件列表（每个模块的CMakeLists.txt里写自己的源文件），这样更清晰，也能避免意外引入无关文件
• 用现代CMake语法：尽量用target_*系列命令（比如target_include_directories、target_link_libraries）替代全局命令，依赖关系更清晰，维护起来也更轻松
• 结合专业测试框架：比如Google Test，CMake的FetchContent模块可以自动拉取并集成，配合CTest能更高效地管理和运行测试

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