Swift Package Manager中Package.resolved文件末尾version字段相关问询

一、version字段的含义 #

• version 1：SPM早期的依赖解析格式，仅记录包的版本/提交哈希、基础依赖关系，不追踪对依赖包的本地化修改（比如通过swift package edit命令修改的代码）。
• version 2：SPM更新后的格式，核心新增了对本地编辑依赖的状态记录。当你用swift package edit修改某个依赖的代码后，该变更会被写入version 2的文件中，确保协作者拉取项目或重新解析依赖时，能复现本地修改的状态。

二、不同version版本的影响 #

• 兼容性问题：高版本的Xcode/SPM可以正常读取version 1的文件，但如果项目依赖了version 2特有的本地编辑状态，用旧版SPM打开会丢失这些修改记录，导致依赖解析结果不一致。
• 协作冲突：两个工作区的resolved文件版本不同时，合并代码容易出现格式冲突，尤其是其中一个使用了本地编辑依赖、另一个没有的场景。
• 解析逻辑差异：version 2会优先尊重本地编辑的依赖状态，而version 1仅按原始依赖规则解析，可能导致两边拉取的依赖版本或代码状态不一致。

三、version变更的原因 #

• 使用swift package edit命令：一旦对任意依赖执行本地编辑操作，SPM会自动将resolved文件的version升级到2，因为需要记录编辑状态。
• SPM/Xcode版本升级：高版本的Xcode（如Xcode 12及以后）在执行swift package update等操作时，若检测到需要新格式支持，会自动升级resolved文件的version。
• 手动修改文件：如果手动修改了resolved文件的结构，SPM重新生成文件时可能会变更version（不建议手动修改该文件）。

四、如何让两个工作区的version保持一致 #

• 统一为version 1：确保两个工作区都未使用swift package edit修改依赖，删除各自的Package.resolved文件，然后执行swift package resolve命令，SPM会生成不包含本地编辑记录的version 1文件。
• 统一为version 2：在其中一个工作区对任意依赖执行swift package edit <package-name>（即使编辑后立刻用swift package unedit <package-name>撤销），SPM会将resolved文件升级到version 2，之后将该文件复制到另一个工作区即可。后续两个工作区的依赖操作都会维持version 2格式。
• 统一SPM/Xcode版本：不同版本的SPM对resolved文件的处理逻辑存在差异，保持两边使用相同版本的Xcode/SPM，能减少版本自动变更的概率。

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