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. 删除大文件并重新提交

1. 删除大文件

2. 重新提交

   git add .
   git commit -m "修复：删除大文件并重新提交"
   

3. 强制推送更改到远程仓库

   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命令从暂存区中删除文件，但保留工作区中的文件。这可以用于清理历史记录中的大文件，同时保留本地文件。

注意事项

1. 备份仓库：在执行任何重写历史记录的操作之前，建议备份你的仓库。
2. 通知协作者：重写历史记录会影响其他协作者，需要通知他们重新克隆仓库。
3. 避免大文件：在未来的开发中，尽量避免提交大文件，可以使用Git LFS（Large File Storage）来管理大文件。

总结

通过上述步骤，成功解决了因大文件导致的Git推送失败问题，并恢复了误删的提交。在日常开发中，合理管理文件大小和历史记录，可以避免类似问题的发生。