Xcode13.1引入的SPM包突发Failed to parse the manifest file错误如何解决？

问题复现条件 #

• 项目此前SPM依赖运行完全正常，无配置改动前提下突发报错
• 构建项目、重置SPM缓存操作均失败，几乎所有依赖包都触发Failed to parse the manifest file错误
• 新建系统用户、全新克隆代码仓库均无法解决问题，错误出现后无法自行恢复
• 多台设备可独立复现相同问题

对应环境范围 #

• Xcode 13.1
• macOS 11.6、macOS 12.0.1

错误截图 #

修复步骤 #

按优先级从高到低尝试以下操作：

• 完全退出Xcode后，执行命令清理全局SPM缓存：

  rm -rf ~/Library/Caches/org.swift.swiftpm
  rm -rf ~/Library/org.swift.swiftpm
  

• 清理Xcode衍生数据：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 检查是否有依赖包使用动态分支（如main/master分支）作为版本规则，若存在可先固定为具体tag版本，排除上游包Manifest更新导致的Xcode 13.1兼容性问题
• 临时关闭系统全局代理后，在Xcode菜单栏选择File > Packages > Reset Package Caches重新拉取依赖，Xcode 13.1存在代理场景下证书校验失败、Manifest文件下载不完整的已知bug
• 如以上操作均无效，可升级到Xcode 13.4.1版本，该版本修复了大量SPM Manifest解析相关兼容性问题，且兼容macOS 11.6及以上系统

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