Xcode如何查询文件更新触发重编的build targets

Xcode 原生没有提供开箱即用的 build target 依赖关系可视化图谱功能，但自带的构建日志、命令行工具完全可以满足你排查单文件修改触发重编范围、梳理target依赖链路的需求，具体方法如下：

这是排查你当前问题最高效的方式，不需要先梳理全量依赖：

• 打开Xcode左侧导航栏的报告导航（快捷键⌘+9）
• 保留现有构建缓存（不要执行clean操作，否则无法复现真实增量构建场景），修改你要测试的目标文件后执行一次构建（快捷键⌘+B）
• 在本次构建记录的搜索框中输入Must rebuild或Due to，即可直接过滤出所有被判定需要重编的target，同时会标注每个target触发重编的直接原因：是头文件传递依赖、错误配置的target依赖，还是文件被错误加入了多个target的编译源列表。

如果需要梳理项目整体的依赖链路，可以用Xcode自带的命令行工具导出结构化依赖数据：

• 打开终端，切换到项目.xcodeproj或.xcworkspace文件所在目录
• 执行命令查看scheme和target的基础依赖列表：
  纯项目文件执行：xcodebuild -list -project 你的项目名.xcodeproj
  若使用CocoaPods等生成workspace，执行：xcodebuild -list -workspace 你的项目名.xcworkspace -scheme 你的主scheme名
• 如果需要文件到target级别的细粒度依赖，可以执行构建命令导出完整构建配置日志：
  xcodebuild -scheme 你的主scheme名 build -showBuildSettings > full_build_deps.txt
  日志中会明确记录每个target的头文件搜索路径、链接依赖、编译阶段输入输出规则，顺着链路即可定位无效依赖的位置。

这类问题90%都是由以下配置错误导致，可以优先排查：

• 公共头文件设计问题：大量通用逻辑、甚至实现代码被放在全局引用的头文件中，只要修改该头文件，所有间接、直接引用它的target都会触发重编，是C++项目最常见的重编耗时问题
• Target Membership配置错误：被修改的文件被意外勾选加入了多个不相关target的「Compile Sources」构建阶段，每次修改都会被所有关联target编译
• Target Dependencies配置冗余：为了省事在target的「Target Dependencies」「Link Binary With Libraries」阶段添加了实际不需要的依赖，导致依赖链路被不合理拉长
• 自定义脚本配置错误：项目中添加的Run Script Phase没有正确配置Input Files/Output Files路径，Xcode会默认每次构建都执行该脚本，连带触发所有依赖该脚本输出的target重编

如果你确实需要可视化的依赖图，可以把导出的依赖关系整理成节点-边结构的DOT格式，用Graphviz生成对应的图形即可，不需要依赖Xcode的原生功能。

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