Git推送大文件导致提交回退的完整解决记录
问题背景
在向Gitee推送代码时,因单文件超过平台限制(100MB),推送被拒绝:
> git push origin master:master
remote: File [6322bc3f1becedcade87b5d1ea7fddbdd95e6959] size 178.312MB, exceeds quota 100MB
remote: Please remove the file[s] from history and try again
To https://gitee.com/next123/work-tce.git
! [remote rejected] master -> master (pre-receive hook declined)
error: failed to push some refs to 'https://gitee.com/next123/work-tce.git'
误操作使用git reset --hard HEAD~1
回退提交,导致本地未提交的修改丢失。
关键操作日志与恢复过程
1. 错误操作后的本地记录
通过git reflog
查看完整操作历史(关键节点已标红):
a2f1787 (origin/master) HEAD@{5}: commit: 修改
61ccfd2 HEAD@{6}: reset: moving to HEAD~1 # 错误操作:硬重置到前一个提交
b250046 HEAD@{8}: reset: moving to HEAD~1
08df7ed HEAD@{9}: reset: moving to HEAD
08df7ed HEAD@{11}: reset: moving to HEAD
08df7ed HEAD@{12}: commit (amend): 修改
95a43d8 HEAD@{13}: commit: 修改
b250046 HEAD@{14}: commit: 修改
61ccfd2 HEAD@{16}: reset: moving to HEAD~
d54fc61 HEAD@{17}: commit: 修改
61ccfd2 HEAD@{18}: reset: moving to HEAD~
47dd530 HEAD@{19}: reset: moving to HEAD~
419759c HEAD@{20}: commit: 删除命令
47dd530 HEAD@{21}: commit: 修改
61ccfd2 HEAD@{22}: commit: 添加文档
78a0c9f HEAD@{24}: commit: 添加代码,修改文档
487f495 HEAD@{25}: commit: 添加文档
c3cc049 HEAD@{26}: commit: 添加文档
2. 恢复丢失的提交
通过git reset --soft
恢复误删的提交(保留工作区内容):
# 定位到含大文件的提交节点 61ccfd2
git reset --soft 61ccfd2
3. 删除大文件并重新提交
-
删除大文件
-
重新提交
git add . git commit -m "修复:删除大文件并重新提交"
-
强制推送更改到远程仓库
git push origin --force
文件恢复的原因
Git的文件恢复能力主要依赖于以下机制:
1. Git的提交历史
Git会记录每次提交的历史,包括文件的添加、修改和删除。即使文件被删除,它仍然存在于历史记录中,直到被垃圾回收机制清理。
2. git reflog
git reflog
记录了HEAD指针的所有移动历史,包括reset
、checkout
等操作。通过reflog
,可以找到被重置的提交,从而恢复文件。
3. git reset --soft
git reset --soft
命令将HEAD指针移动到指定的提交,但保留工作区和暂存区的更改。这使得可以恢复到某个特定的提交状态,并重新提交。
4. git reset --hard
git reset --hard
命令将HEAD指针移动到指定的提交,丢弃工作区和暂存区的更改。此操作不可逆,慎用!
5. git rm --cached
git rm --cached
命令从暂存区中删除文件,但保留工作区中的文件。这可以用于清理历史记录中的大文件,同时保留本地文件。
注意事项
- 备份仓库:在执行任何重写历史记录的操作之前,建议备份你的仓库。
- 通知协作者:重写历史记录会影响其他协作者,需要通知他们重新克隆仓库。
- 避免大文件:在未来的开发中,尽量避免提交大文件,可以使用Git LFS(Large File Storage)来管理大文件。
总结
通过上述步骤,成功解决了因大文件导致的Git推送失败问题,并恢复了误删的提交。在日常开发中,合理管理文件大小和历史记录,可以避免类似问题的发生。