iPhone 12 Pro Max启动应用时Xcode缺少TARGET_BUILD_DIR构建设置如何解决

核心原因 #

该报错是Xcode构建iOS项目时，未读取到指定的TARGET_BUILD_DIR构建设置导致，通常由项目缓存过期、Pod配置冲突、Xcode/Flutter版本不兼容触发。

分步解决 #

• 清理缓存与重建依赖
  在项目根目录依次执行以下命令，清除所有过期构建产物和依赖配置：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock
  rm -rf ~/Library/Developer/Xcode/DerivedData/*
  flutter pub get
  cd ios && pod install --repo-update
  

  执行完成后重新启动项目，多数缓存类问题可直接解决。
• 手动校验Xcode构建设置
  打开项目iOS目录下的Runner.xcworkspace（禁止直接打开Runner.xcodeproj，否则会丢失Pod配置），依次点击左侧导航栏的Runner项目 -> TARGETS栏下的Runner -> 顶部Build Settings选项卡，搜索TARGET_BUILD_DIR：
  如果该配置项不存在，手动添加，值设置为$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)；如果已存在但值被修改，重置为默认值即可。
• 检查版本兼容性
  执行flutter doctor查看iOS相关配置告警，按照提示完成修复。如果是升级Xcode或Flutter后出现的问题，优先将两者都升级到最新稳定版，避免跨大版本适配问题。
• 重置Xcode默认配置
  以上操作都无效的情况下，执行命令重置Xcode全局配置：

  defaults delete com.apple.dt.Xcode
  

  重启Xcode后重新运行项目即可。

内容的提问来源于stack exchange，提问作者K'man Amuda Jr.