看起来你已经照着文档写好了Package.swift，但还是碰到了问题，别慌，咱们一步步来排查可能的问题：

• 先确认URL与校验和的准确性
  这是最常见的出错点：

  • 先手动打开你写的URL，确认能正常下载到metro_booking.xcframework.zip文件，检查URL里的版本号、路径拼写（包括大小写）有没有错误；
  • 校验和必须完全匹配，你可以下载这个zip包到本地，然后用命令行计算正确的校验和：

    swift package compute-checksum /path/to/metro_booking.xcframework.zip
    

    把计算出来的字符串和你Package.swift里的checksum字段对比，只要有一个字符不对就会报错。

• 验证XCFramework本身的有效性
  下载下来的zip包解压后，右键点击metro_booking.xcframework选择「显示包内容」，检查内部结构：

  • 有没有包含你需要的平台目录（比如ios-arm64、ios-x86_64-simulator等）；
  • 每个平台目录下的框架文件是否完好，没有损坏；
    你也可以先尝试本地引用这个XCFramework来测试，把binaryTarget改成本地路径的形式：

  .binaryTarget(
      name: "metro_booking",
      path: "./metro_booking.xcframework"
  )
  

  如果本地能正常编译，说明问题出在远程包的下载或校验环节；如果本地也报错，那就是XCFramework本身打包有问题，需要重新生成。

• 检查SPM配置的平台兼容性
  确认你的SPM包支持的平台和XCFramework的支持范围一致：

  • 在Package初始化里加上平台配置，比如你的XCFramework支持iOS 13+，就添加：

    platforms: [.iOS(.v13)],
    

  • 确保binaryTarget的name和依赖里的名称完全一致（大小写也不能错），你代码里的"metro_booking"看起来是匹配的，但还是要再核对一遍。

• 清理缓存重新构建
  SPM的缓存有时候会导致奇怪的问题，试试这些操作：

  • 在Xcode里选择File -> Packages -> Reset Package Caches；
  • 手动删除本地缓存目录：~/Library/Caches/org.swift.swiftpm；
  • 用命令行重新解析依赖：

    swift package clean
    swift package resolve
    

  命令行的错误提示往往比Xcode更详细，能帮你定位具体问题。

• 查看完整错误日志
  Xcode的错误提示有时候比较简洁，点击错误信息旁边的展开箭头，查看完整的构建日志，里面会给出具体的错误原因：比如「校验和不匹配」「无法下载远程包」「XCFramework不支持当前平台」等，根据这些提示针对性解决就好。

内容来源于stack exchange