复制含未提交更改的Git仓库后提交报错：failed to stat 'HEAD...'求助

问题排查 #

这个报错的核心原因是你的Git仓库的HEAD引用文件被损坏了——里面被重复写入了大量HEAD字符串，导致Git错误地把这个长串当成了要访问的文件路径，自然找不到对应文件，抛出了stat失败的错误。

这种情况通常发生在直接复制带有未提交更改的仓库目录（而非使用git clone）时，.git目录里的引用文件可能因为文件系统复制的异常出现损坏。

修复步骤 #

1. 检查并修复.git/HEAD文件 #

找到仓库根目录下的.git/HEAD文件（这是个纯文本文件，用普通编辑器就能打开），正常情况下它的内容应该是类似这样的：

ref: refs/heads/feature/servicing/pal4_Migration2

如果你的文件里是一堆重复的HEAD字符串（比如HEADHEADHEAD...），直接把内容改成上面的格式，替换成你当前所在的分支名（也就是你刚创建的feature/servicing/pal4_Migration2）。

2. 验证仓库状态 #

修改完HEAD文件后，执行以下命令确认仓库状态是否恢复正常：

git status

如果能正常显示你之前修改的三个文件（.idea/libraries/tsconfig_roots.xml、ui/dev/pages/AbstractChecks.ts、ui/dev/pages/availabilities/avac/AvacChecks.ts），说明HEAD文件修复成功。

3. 重新提交更改 #

现在可以重新执行提交命令，建议直接带上提交信息避免额外问题：

git commit -n -m "你的提交描述内容"

4. 预防后续问题 #

如果这次是直接复制仓库目录导致的问题，以后建议用git clone来复制仓库，哪怕是本地仓库也适用：

git clone /path/to/your/original/repo /path/to/new/repo

这样能保证.git目录的完整性，避免文件系统复制带来的损坏。

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