Git push 报错:Updates were rejected 完整排查与解决方案

17次阅读
没有评论

场景:执行 git push 推送代码时被拒绝,终端提示远程存在本地没有的提交

报错原文

hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

报错原因

远程分支上已经有新的提交记录,而你的本地仓库还没有同步这份代码。 一般是这两种情况:

  1. 同分支下其他协作者已经先推送了代码;
  2. 你换了设备,在另一台电脑提交并推送到了同一个分支。

Git 为了防止直接覆盖丢失远程的改动,直接拦截了本次 push。

方案一:标准安全流程(多人协作 ✅ 首选推荐)

先拉取远程最新代码、合并冲突,再推送,不会丢代码。

# 拉取远程分支并自动合并
git pull origin 你的分支名
# 示例:git pull origin main

👉 如果出现代码冲突: 文件里会有冲突标记 <<<<<<< HEAD,手动确认并修改冲突内容,处理完成后:

git add .
git commit -m "merge: 合并远程更新"
git push origin 你的分支名

说明:git pull 等价于 git fetch + git merge

方案二:先预览远程改动,再手动合并(适合谨慎核对)

不想自动合并,先拉取远程信息、查看差异:

git fetch origin
# 对比本地和远程分支差异
git diff origin/你的分支名
# 确认无误后再合并
git merge origin/你的分支名

合并完成后正常 git push。

方案三:强制覆盖远程(⚠️ 高危!慎用)

多人公共分支(main/master)禁止使用,只适合自己单人私有分支

# 危险强制推送,直接覆盖远程,容易弄丢别人提交
git push --force origin 你的分支名

推荐用更安全的替代:--force-with-lease 它会先校验远程分支状态,只有远程没有新增提交时才允许强制推送,降低误删风险:

git push --force-with-lease origin 你的分支名

开发规范小结

  1. 多人协作原则:每次 push 之前先 pull,保持本地和远程同步;
  2. 主分支不要随便 force push,一旦覆盖别人提交,恢复成本很高;
  3. 优先用 pull /fetch + merge,强制推送永远是最后备选方案。
正文完
可以使用微信扫码关注公众号(ID:xzluomor)
post-qrcode
 0
评论(没有评论)
验证码