XCode 14.3+SwiftUI适配iOS14.0时出现Could not build module问题求助

问题背景 #

• 开发环境：Xcode 14.3，SwiftUI项目，目标iOS版本14.0
• 编译错误：共11个Could not build module '...'类型错误，涉及系统框架依赖链问题，示例错误：

  /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.4.sdk/System/Library/Frameworks/Accessibility.framework/Headers/AXFoundation.h:8:9 Could not build module 'CoreGraphics'
  /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.4.sdk/System/Library/Frameworks/CFNetwork.framework/Headers/CFNetwork.h:18:10 Could not build module 'CoreFoundation'
  /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.4.sdk/System/Library/Frameworks/CoreFoundation.framework/Headers/CFStream.h:20:10 Could not build module 'Dispatch'

• 已尝试无效操作：删除并重新安装Pods、卸载重装Xcode、清理构建文件夹/模拟器、重启电脑、创建新Xcode项目、删除Derived Data

针对性解决方案 #

1. 检查系统SDK权限与完整性 #

• 打开终端，执行命令检查SDK框架目录权限：

  ls -ld /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.4.sdk/System/Library/Frameworks/
  

  确保输出权限为drwxr-xr-x，若权限异常，执行修复命令：

  sudo chmod -R 755 /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.4.sdk/System/Library/Frameworks/
  

• 打开Xcode，进入Xcode > Settings > Platforms，确认iOS 16.4 SDK显示为「Installed」，若异常则点击「Download」重新安装对应SDK

2. 清理项目Build Settings中的无效路径 #

• 打开项目Build Settings，搜索Framework Search Paths，清空所有无关的系统SDK路径，仅保留自定义框架的必要路径
• 搜索Header Search Paths，同样清理无效路径，只保留项目自定义头文件路径
• 搜索Enable Modules (C and Objective-C)，确保设置为YES
• 搜索Module Cache Path（位于Apple Clang - Language - Modules下），修改为$(PROJECT_DIR)/DerivedData/ModuleCache，规避系统路径权限问题

3. 重置Xcode全局模块缓存 #

• 终端执行命令删除用户级模块缓存：

  rm -rf ~/Library/Developer/Xcode/DerivedData/ModuleCache.noindex/
  

• 执行命令删除系统级模块缓存（需输入系统密码）：

  sudo rm -rf /Library/Caches/com.apple.xcode.macOS.frameworks/
  

4. 统一项目与Pods的部署目标 #

• 打开Podfile，确保顶部声明platform :ios, '14.0'，执行pod install重新安装Pods
• 确认项目Build Settings中的iOS Deployment Target为14.0，Base SDK设置为Latest iOS (iOS 16.4)

5. 修复系统框架依赖 #

• 进入项目Build Phases > Link Binary With Libraries，移除已添加的报错系统框架（CoreGraphics、CoreFoundation等），再从Xcode系统框架列表中重新添加，确保状态为Required

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