Git拉取时出现fatal: bad object refs/heads/main (1)错误的解决方法

问题背景 #

本地仓库执行git push时提示分支落后，执行git pull遇到fatal: bad object refs/heads/main错误，尝试git gc、git reset --hard等操作均无效，本地Git分支引用已损坏。

解决方案 #

方案一：重新克隆远程仓库（最稳妥） #

由于你可接受重新拉取内容并重做本地修改，这是最快解决问题的方式：

• 备份本地仓库中未提交的修改文件到其他目录
• 删除当前损坏的本地仓库文件夹
• 在终端执行克隆命令：

git clone https://github.com/[你的域名]/website.git

• 将备份的修改文件复制到新克隆的目录，重新进行修改、提交和推送

方案二：修复本地Git引用（保留原目录） #

若想保留当前本地目录，可尝试手动修复损坏的分支引用：

1. 获取远程main分支的最新commit哈希：

git ls-remote origin main

执行后会输出类似a1b2c3d... refs/heads/main的结果，复制其中的哈希字符串（如a1b2c3d）
2. 手动重置本地main分支到该远程哈希：

git update-ref refs/heads/main a1b2c3d

3. 清理Git仓库中的损坏对象：

git gc --prune=now

4. 再次尝试拉取远程内容：

git pull

完成后执行git status确认分支状态正常，即可继续后续的推送操作。

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