如何删除GitLab项目中误传内容及对应提交历史记录？

前置准备 #

• 提前备份本地完整项目代码，避免操作失误导致内容丢失
• 提前和项目其他成员同步，告知你将修改分支提交历史，操作期间请暂停推送，操作完成后再同步最新代码
• 确保本地已经安装Git，可通过右键打开Git Bash或者PowerShell执行Git命令

操作步骤 #

步骤1：定位误提交记录 #

进入本地项目根目录，执行命令查看提交历史：
git log --oneline
从输出结果中找到你误提交的记录对应的7位commit id，以及你要回退到的正确提交的commit id。

步骤2：清除本地误提交历史 #

分两种场景选择操作：

1. 误提交是最近1次提交，无其他成员拉取过该错误提交
   执行命令直接回退到上一个正确提交，彻底抹掉最近1次的提交内容：
   git reset --hard HEAD~1
   如果需要回退多笔最近的提交，将HEAD~1中的1改为对应要删除的提交数量即可。

2. 误提交不是最新提交，或中间包含其他成员的合法提交
   执行交互式变基命令，将[正确提交id]替换为你误提交之前的最后一笔正确提交的id：
   git rebase -i [正确提交id]
   在弹出的编辑界面中，找到你误提交的记录，将行首的pick改为drop，保存退出后Git会自动删除对应提交的所有内容。

步骤3：强制推送修正后的历史到GitLab #

执行命令覆盖远程分支的历史，将[分支名]替换为你实际提交的分支名（如main、master等）：
git push origin [分支名] --force

若推送被拒绝，说明该分支为GitLab保护分支，需联系项目管理员临时关闭对应分支的「禁止强制推送」规则，推送完成后再重新开启即可。

步骤4：清除GitLab服务器缓存 #

1. 进入GitLab对应项目页面，依次点击「设置」-「仓库」-「高级」
2. 找到「清理」板块，点击「运行清理」，即可删除服务器残留的错误提交缓存对象

后续注意事项 #

• 所有项目成员需要在你操作完成后执行以下命令同步最新分支历史，避免错误提交被重新推送：
  git fetch origin
git reset --hard origin/[分支名]
• 不要在公共分支上随意修改历史提交，本方案仅适用于本次误提交的紧急修复

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