CMake简单项目结构下如何自动按引入头文件关联对应源文件链接

方案1：启用链接阶段死代码裁剪（改动最小，完全保留原有工作流） #

这个方案不需要修改你现有的文件管理逻辑，新增文件依然只需要添加到对应列表即可，仅需要给现有CMakeLists增加几行编译/链接选项，就能让最终生成的可执行文件自动丢弃所有未使用的静态库代码，效果和仅链接依赖的源文件完全一致。

适配后的CMakeLists示例 #

include_directories(include)

set(HEADERS
  include/file1.hpp
  include/file2.hpp
  include/sub1/file3.hpp
  include/sub2/file4.hpp
  )

set(SOURCE_FILES
  src/file1.cpp
  src/file2.cpp
  src/sub1/file3.cpp
  src/sub2/file4.cpp
  )

set(EXECUTABLE_FILES
  cli/app1.cpp
  cli/app2.cpp
  cli/app3.cpp
  )

add_library(code STATIC ${SOURCE_FILES} ${HEADERS})
# 给静态库添加编译选项，将每个函数/数据放到独立的段中
target_compile_options(code PRIVATE
  $<$<CXX_COMPILER_ID:GNU,Clang>:-ffunction-sections -fdata-sections>
  $<$<CXX_COMPILER_ID:MSVC>:/Gy>
)

foreach (file ${EXECUTABLE_FILES})
    get_filename_component(executable ${file} NAME_WE)
    add_executable(${executable} ${file})
    target_link_libraries(${executable} code)
    # 给可执行文件添加链接选项，自动丢弃未使用的段
    target_link_options(${executable} PRIVATE
      $<$<CXX_COMPILER_ID:GNU,Clang>:-Wl,--gc-sections>
      $<$<CXX_COMPILER_ID:MSVC>:/OPT:REF>
    )
endforeach ()

适用场景 #

绝大多数场景下这个方案完全够用，裁剪精度足够高，且没有额外维护成本。仅当你的代码里存在大量未被显式调用但需要保留的全局构造函数、弱符号等特殊逻辑时，才需要考虑下面的方案。

方案2：自动扫描头文件依赖，按需链接编译单元 #

如果你确实需要完全不链接未使用的源文件，可以利用CMake的文本扫描能力自动匹配依赖，仅需要新增少量通用逻辑，依然保持「新增文件仅添加到对应列表」的工作流。
核心逻辑是：

1. 维护头文件到对应源文件的映射表
2. 配置阶段自动扫描每个cli入口文件的#include指令，提取依赖的头文件
3. 自动将对应源文件添加到当前可执行文件的编译列表

核心实现片段 #

# 新增：构建头文件到源文件的映射
set(HDR_TO_SRC_MAPPING)
foreach(src ${SOURCE_FILES})
  # 把src/xxx.cpp替换成include/xxx.hpp，匹配你的命名规则
  string(REPLACE "src/" "include/" hdr ${src})
  string(REPLACE ".cpp" ".hpp" hdr ${hdr})
  list(APPEND HDR_TO_SRC_MAPPING ${hdr} ${src})
endforeach()

foreach (file ${EXECUTABLE_FILES})
    get_filename_component(executable ${file} NAME_WE)
    # 扫描当前入口文件的所有include头文件
    file(STRINGS ${file} INCLUDES REGEX "^#include[ \t]*[<\"]include/.*[>\"]")
    set(DEP_SRCS ${file})
    foreach(inc ${INCLUDES})
      # 提取include的头文件路径
      string(REGEX REPLACE "^#include[ \t]*[<\"](include/.*)[>\"]" "\\1" hdr ${inc})
      # 查找对应源文件
      list(FIND HDR_TO_SRC_MAPPING ${hdr} idx)
      if(NOT idx EQUAL -1)
        math(EXPR src_idx "${idx} + 1")
        list(GET HDR_TO_SRC_MAPPING ${src_idx} src)
        list(APPEND DEP_SRCS ${src})
      endif()
    endforeach()
    # 用扫描到的依赖源文件编译可执行文件，不需要再链接大静态库
    add_executable(${executable} ${DEP_SRCS})
endforeach ()

注意事项 #

• 扫描仅在CMake执行配置阶段（生成构建文件时）生效，如果你修改了cli文件的#include列表，需要重新运行CMake配置才能更新依赖
• 仅适配你当前头文件和源文件严格一一对应的命名规则，如果后续规则变化需要调整映射逻辑

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