如何查看CMake构建目标或修改文件时将被重编译的文件

CMake 本身只负责生成构建系统配置，实际的增量重编译判定是由你选用的底层构建器（Ninja、GNU Make、MSBuild 等）执行的，不需要修改项目配置，直接通过构建器自带的能力就能精准拿到你要的结果，全程不需要真的跑完整个编译流程：

• 无副作用预演查询（最常用）
  直接用构建器的 dry run 模式，输出所有待执行的构建任务，过滤编译步骤就能拿到完整的重编译列表：
  • 如果你用 Ninja 生成器（大型C++项目优先选这个构建器，增量构建速度、输出清晰度都远优于Make），执行以下命令即可：

    # 查询全量构建时待重编译的所有单元
    cmake --build <你的构建目录路径> -- -n
    # 查询指定目标构建时待重编译的单元
    cmake --build <你的构建目录路径> --target <目标名> -- -n
    

    命令里的-n是传给Ninja的预演参数，不会真的执行编译、链接操作，只会把所有要跑的命令完整打印出来，你可以直接从输出里筛出.c/.cpp/.cc等翻译单元路径、以及对应的目标名。
  • 如果你用 GNU Make 生成器，命令格式完全一致，-n参数同样适用，只是Make输出的冗余信息会更多，建议配合grep过滤。
  • 如果你用 MSBuild（Visual Studio）生成器，给构建命令传/dryRun /v:minimal参数，即可输出待执行的编译任务列表。
• 追溯重编译触发原因
  如果你不仅要知道哪些文件会重编译，还要定位重编译的触发链路（比如某个源文件是因为传递依赖了哪个你修改过的头文件才被拉起重编译），可以开构建器的依赖调试模式：
  Ninja 下直接执行：

  ninja -C <你的构建目录路径> -d explain <可选填目标名>
  

  输出会在每条编译任务前标注触发原因：比如是因为某文件修改时间变更、编译选项改动、依赖的库文件更新，对你排查冗余头文件依赖、定位不合理的模块化问题非常实用。
  Make 下可以传-d参数输出调试日志，不过信息密度极低，建议过滤Prerequisite相关的行查看依赖判定逻辑。
• 静态预判文件修改的影响范围
  如果你想在修改文件之前就提前评估改动的影响面，可以直接导出全项目的依赖索引：
  Ninja 下执行ninja -C <构建目录路径> -t deps，会输出所有翻译单元的完整头文件依赖列表，你可以写个简单脚本做反向映射：输入任意文件路径，就能直接查到所有直接/间接依赖它的翻译单元、以及这些单元归属的构建目标，不需要反复跑预演命令。

针对你提到的重构场景补充：配置CMake时加上-DCMAKE_CXX_INCLUDE_WHAT_YOU_USE=iwyu参数，配合IWYU工具可以自动扫描出每个头文件、源文件里的冗余include，比手动清理不必要的头文件依赖效率高很多。

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