Xcode 14.2出现“本地仓库处于不支持状态”错误的解决求助

第一步：彻底清理Git仓库状态（必须关闭Xcode再操作） #

• 关闭Xcode，避免后台进程干扰Git操作
• 打开终端，切换到项目根目录，依次执行以下命令：
  • git reset --hard HEAD：硬重置到当前分支最新提交，彻底丢弃所有本地修改
  • git clean -fd：删除所有未跟踪的文件、文件夹和忽略文件
  • git stash drop：如果还有残留的stash记录，直接丢弃
  • git status：确认输出显示nothing to commit, working tree clean，确保仓库状态干净

第二步：清除Xcode缓存与Git锁文件 #

• 删除Xcode的Derived Data：
  1. 打开Xcode，点击顶部菜单栏的Xcode > 设置 > 位置
  2. 找到「Derived Data」，点击右侧箭头打开文件夹，删除当前项目对应的文件夹
• 清理Git索引锁文件（如果存在）：
  回到终端项目目录，执行rm -rf .git/index.lock，强制删除可能存在的Git锁
• 深度清理Git冗余数据：
  执行git reflog expire --expire=now --all && git gc --prune=now --aggressive，清理Git的过期引用和垃圾文件

第三步：重新加载项目 #

• 重新打开Xcode并加载项目，等待Xcode完成索引
• 检查分支旁的黄色感叹号是否消失，尝试切换分支验证状态

如果以上步骤都无效，直接重新克隆仓库到新目录，再用Xcode打开即可解决。

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