CMake（C/C++）项目源文件变更后如何导出受影响目标列表

针对你在CMake C/C++项目中，想要追踪单个源文件变更所影响的目标（含传递依赖）的需求，我结合你提到的几个方案，整理出最靠谱的实现路径：

一、优先选择：解析Ninja构建文件（你的方案1） #

这是最贴近实际构建逻辑的方案，因为Ninja文件是CMake生成的真实构建依赖规则，能精准反映源文件与目标、目标与目标之间的依赖关系。具体步骤如下：

1. 生成Ninja构建文件
   执行cmake -GNinja ..生成Ninja构建系统，此时CMake会在CMakeFiles/<target>.dir/目录下生成每个目标对应的.o.d文件，这些文件记录了.o目标文件依赖的所有源文件、头文件。

2. 建立「源文件→.o文件」映射
   遍历所有.o.d文件，解析其中的依赖规则（格式类似file.o: src.cpp include/header.h），把每个源文件（建议转成绝对路径避免歧义）关联到对应的.o文件。

3. 建立「.o文件→目标」映射
   打开主构建文件build.ninja，查找其中的链接规则（比如build my_executable: LINK_EXECUTABLE CMakeFiles/my_executable.dir/file1.o CMakeFiles/my_executable.dir/file2.o），将每个.o文件关联到最终的目标（可执行文件、静态库/动态库等）。

4. 追踪传递依赖
   在build.ninja中，目标之间的依赖也会被明确记录（比如库my_lib依赖my_dep_lib，则my_lib的构建规则会依赖my_dep_lib的目标文件）。通过遍历依赖链，就能把所有间接受影响的目标（包括自定义目标）都找出来。

二、方案2（Graphviz输出）的局限性 #

CMake的--graphviz=output.dot选项生成的是静态项目结构依赖图，它展示的是目标之间的顶层依赖关系，但无法精准对应到单个源文件的影响——比如条件编译的源文件可能不会出现在图中，而且它不包含源文件到目标的细粒度映射。这个方案只能作为辅助参考，不能作为核心实现方式。

三、方案3（自定义目标依赖）的处理 #

你提到的add_dependencies()添加的自定义目标依赖，完全可以和方案1结合处理：build.ninja会把这类依赖明确写入构建规则（比如build my_custom_target: CUSTOM_COMMAND ... | my_lib），在解析build.ninja的依赖链时，只要追踪所有目标的前置依赖，就能把自定义目标的依赖也纳入范围。

四、进阶补充：用CMake脚本直接查询依赖 #

如果不想解析外部构建文件，可以用CMake自身的API写脚本直接获取依赖关系，适合跨构建系统的场景：

写一个track_deps.cmake脚本：

# 遍历项目中所有目标
get_cmake_property(all_targets BUILDSYSTEM_TARGETS)
foreach(target IN LISTS all_targets)
    # 获取目标关联的源文件
    get_target_property(src_files ${target} SOURCES)
    if(src_files)
        foreach(src IN LISTS src_files)
            # 转换为绝对路径，避免路径歧义
            get_filename_component(src_abs "${src}" ABSOLUTE)
            # 记录源文件与目标的映射
            list(APPEND source_target_map "${src_abs}=${target}")
        endforeach()
    endif()
    # 获取目标依赖的其他目标（过滤系统库）
    get_target_property(linked_targets ${target} LINK_LIBRARIES)
    if(linked_targets)
        foreach(linked IN LISTS linked_targets)
            if(TARGET ${linked})
                list(APPEND target_dep_map "${target}=${linked}")
            endif()
        endforeach()
    endif()
endforeach()

# 输出映射结果到文件
file(WRITE source_target_mapping.txt "${source_target_map}")
file(WRITE target_dependency_mapping.txt "${target_dep_map}")

执行cmake -P track_deps.cmake就能生成源文件到目标、目标到目标的映射文件。不过要注意：这种方式只能获取CMake静态解析的依赖，对于生成的源文件（比如add_custom_command生成的）需要额外处理，且无法反映构建时的动态依赖。

总结 #

最佳实践是方案1为主，CMake脚本为辅：Ninja文件解析能提供最精准的构建依赖，而CMake脚本可以补充静态依赖信息，两者结合能覆盖绝大多数场景。如果你的项目固定用Ninja构建，优先用方案1即可；如果需要兼容其他构建系统，再结合CMake脚本接口。

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