如何在Xcode 14.3及以上版本中禁用SPM自动包解析？

一、通过Xcode设置关闭自动解析 #

Xcode 14.3及后续版本支持关闭自动包解析，操作步骤如下：

• 打开项目后，在项目导航器中选中项目根文件，切换到Package Dependencies标签页
• 点击页面左下角的齿轮图标，取消勾选**"Update Automatically"**选项

完成设置后，Xcode不会再在切换代码提交、修改依赖配置时自动触发包解析，仅当你主动点击页面中的"Update Packages"或"Resolve Packages"按钮时，才会执行解析操作。

二、锁定依赖版本减少解析触发 #

配合锁定依赖版本，可以进一步避免不必要的解析操作：

• 在项目的Package.swift文件中，将依赖的版本范围修改为具体的tag、固定版本号或commit哈希，示例如下：

  dependencies: [
      // 固定版本号
      .package(url: "https://github.com/example/package.git", exact: "2.1.0"),
      // 具体commit哈希
      .package(url: "https://github.com/example/package.git", revision: "f4d78a9e6c3b")
  ]
  

• 执行swift package resolve命令生成Package.resolved文件，并将该文件提交至版本控制系统，确保团队成员使用一致的依赖版本

三、与Cocoapods处理逻辑的对比 #

你提到的Cocoapods处理方式确实更适配频繁切换分支的场景：

• 依赖过时时构建直接失败，不会在后台执行耗时解析导致界面冻结
• 依赖更新完全由开发者主动触发（pod install/pod update），控制权完全在用户手中

通过上述SPM的设置调整，也能实现类似的可控效果：关闭自动解析后，依赖版本不一致时Xcode会给出明确提示，不会自动执行解析操作，彻底避免切换提交时的界面冻结问题。

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