如何正确地强制推送(force push)

强推的正确姿势是 git push --force-with-lease:推送前校验远程分支没有别人新推的提交,比 --force 安全。强推用于 rebase/amend 后更新个人分支;共享分支禁用。步骤:fetch 确认 → --force-with-lease → 通知协作者。

最佳实践
Git 分支协作与合并示意

用 --force-with-lease 代替 --force:它在覆盖前先检查远程分支是否仍是你上次 fetch 看到的状态——期间有人推了新提交则拒绝,只有期望引用仍匹配时才允许替换,但仍可能覆盖你已知却未保留的远端工作,不能视为零风险。这是强推的"安全带"。

正确流程

# 1. 改写历史(rebase / amend 完成后)
git rebase -i HEAD~3

# 2. 推送前看一眼远程现状
git fetch
expected=$(git rev-parse refs/remotes/origin/feature-x)
git log --left-right --graph --oneline HEAD..."$expected"
# rebase后两边哈希不同很正常,逐项核对将替换的已固定历史

# 3. 带租约强推
git push --force-with-lease=refs/heads/feature-x:"$expected" origin HEAD:refs/heads/feature-x

--force vs --force-with-lease

--force --force-with-lease
覆盖远程 无脑覆盖 远程有新提交时拒绝
适用 明确独占的分支 一切需要强推的场景
风险 覆盖未保留工作 只检查引用匹配,不检查内容安全或他人是否拉取

强推的规矩

  1. 共享分支不强推:main/release 永远走 revert;
  2. 个人分支也需核对影响:rebase 自己的 feature 分支后强推是标准工作流;
  3. 推前打招呼:即使个人分支被同事检出过,强推前说一声,他们应先保存本地工作,再选择rebase或重新建立分支等协调方式,不能一律hard reset。

常见问题(FAQ)

Q:--force-with-lease 还是失败了?

可能是租约不匹配,也可能是权限、分支保护或服务端策略拒绝,先查看具体错误。git log HEAD..origin/分支 看看是什么——是别人的就 merge/rebase 进来,确认可弃再推。

Q:GitHub 上保护分支不允许强推怎么办?

保护分支就是设计成不可强推的。需要"撤销"已推送内容时用 git revert 正向操作;确需强推要找管理员临时解除保护。

Q:能设置默认用 --force-with-lease 吗?

Git 没有 push.useForceWithLease 这个配置项。需要时显式使用 --force-with-lease;不要认为它改变了 git push -f 的行为。后台 fetch 可能更新跟踪引用,重要操作可以指定期望的远程提交哈希,并核对将被覆盖的提交。

参考资料

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台