Xcode无法解析SPM依赖报错：无法访问根路径包（非树对象错误）

报错说明 #

解析特定SPM依赖时突然终止，报错内容：
the package at '/' cannot be accessed (Couldn’t read 'x.x.x': fatal: not a tree object)
（报错界面显示：package无法访问，提示“not a tree object”）

解决方案 #

• 清理SPM缓存与Xcode衍生数据
  打开终端执行以下命令，彻底清除相关缓存文件：

  rm -rf ~/Library/Caches/org.swift.swiftpm
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

  重启Xcode后重新尝试解析依赖。

• 校验依赖版本有效性
  检查该SPM依赖引用的版本号（tag）或commit哈希是否在远程仓库存在：

  • 若引用的是特定commit，大概率是该commit被仓库作者强制推送覆盖或删除，直接替换为仓库的稳定tag版本
  • 若引用的是tag，确认该tag未被删除，或切换到其他可用的稳定版本

• 修复本地Git仓库状态
  进入项目根目录，执行命令刷新远程仓库信息：

  git fetch --prune
  

  若本地仓库存在损坏，建议重新克隆项目后再添加SPM依赖（注意备份本地未提交的修改）。

• 手动引入本地依赖
  找到该依赖的Git仓库地址，手动克隆到本地目录；打开Xcode选择「Add Package Dependency」→「Add Local」，指向克隆好的仓库目录，选择对应版本完成添加。

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