切换Git分支时Package.resolved文件莫名消失的原因及解决办法

成因 #

• Xcode的Swift Package Manager（SPM）实时监控机制：Xcode会持续跟踪Package.resolved文件状态，当Git切换分支/reset时，文件的替换过程被SPM后台进程误识别为无效状态，触发自动清理逻辑删除文件。
• Git与Xcode的竞态条件：Git执行分支切换或reset时，会先删除旧文件再写入新分支的版本，这个短暂的文件缺失被Xcode捕捉，导致SPM错误地将新写入的文件也清理掉。
• 分支间依赖配置差异过大：如果切换的两个分支在依赖数量、版本或来源上差异显著，SPM在同步过程中容易出现逻辑错误，误删Package.resolved。

解决方法 #

• 执行Git操作前关闭Xcode：彻底避免Xcode的文件监控干扰Git的文件操作，完成后重新打开Xcode，SPM会自动加载对应分支的依赖配置。
• 关闭Xcode自动包解析：打开Xcode偏好设置（Preferences）→ Locations → Derived Data → Advanced，选择Custom并设置为Unique；或在项目的Package依赖设置中取消勾选Automatically resolve packages。Git操作完成后，手动执行File > Packages > Resolve Package Versions触发解析。
• 统一分支间依赖结构：若两个分支依赖差异大，先在其中一个分支调整依赖，让Package.resolved的结构尽量接近，再进行分支切换，降低SPM误判概率。
• 锁定依赖版本：在Package.swift中明确指定依赖的具体版本（而非版本范围或分支），减少SPM的动态解析操作，降低文件被误删的可能性。
• 用Git钩子自动恢复：创建Git的post-checkout和post-reset钩子，在操作完成后检查Package.resolved是否存在，若缺失则从当前分支的Git记录中恢复。脚本示例：

#!/bin/sh
if [ ! -f Package.resolved ]; then
    git checkout HEAD -- Package.resolved
fi

将脚本保存为.git/hooks/post-checkout和.git/hooks/post-reset，并执行chmod +x .git/hooks/post-checkout .git/hooks/post-reset赋予执行权限。

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