删除 GitLab 上的错误提交记录
在日常开发中，可能会遇到误将敏感配置、大文件或未完成功能提交并推送到 GitLab 的情况。以下演示如何通过本地回滚和强制推送的方式清理远程仓库历史。
场景还原
- 目标： 删除 GitLab 上的最新一条记录。
- 状态： 代码已推送到远程
master分支，且该分支在 GitLab 上是'受保护'的。
第一步：本地重置 (git reset)
在本地将代码回退到错误提交之前的状态。打开终端进入项目目录，执行：
git reset --hard HEAD~1
--hard：表示彻底丢弃该 commit 的改动（慎用！如果想保留改动只是想重写 commit，请用--soft）。HEAD~1：代表回退到当前位置的上一个版本。
提示： 如果连续 reset 了多次，可以通过 git reset --hard <commit_id> 精确跳转到某一个健康的记录点。
第二步：处理保护分支限制
执行 git push --force 时，GitLab 通常会拒绝：
remote: GitLab: You are not allowed to force push code to a protected branch on this project.
这是因为 Protected Branch 机制在守护仓库，防止误删历史。
第三步：解除 GitLab 页面封印
需要暂时关闭防护罩：
- 登录 GitLab 网页版。
- 进入项目 -> Settings -> Repository。
- 找到 Protected Branches，点击 Expand。
- 在下方列表中找到
master，点击右侧的 Unprotect 按钮。
第四步：强制推送
执行终极指令：
git push origin master --force
屏幕显示：
+ 0fce598...d091c0d master -> master (forced update)
成功！错误的记录已从 GitLab 的历史中被抹除。
第五步：安全收尾 (非常重要！)
删完记录后，请重新开启防护罩：
- 回到 GitLab 的 Protected Branches 页面。
- 在 Protect a branch 下拉框选择
master。 - 设置 Allowed to merge & Allowed to push 为 Maintainers。
- 点击 Protect。
总结与避坑指南
- 警告：
force push会覆盖所有人的远程记录。如果同事已拉取该错误提交，他们的本地仓库会报错。执行前务必通知团队。 - 保护： 分支保护机制是好东西，只有在修复重大历史错误时才建议临时关闭。
- 检查： 永远在
git push --force之前用git log确认一下本地状态。
Git 是版本管理工具，掌握正确操作方法可避免数据丢失风险。
