场景:执行
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.
报错原因
远程分支上已经有新的提交记录,而你的本地仓库还没有同步这份代码。 一般是这两种情况:
- 同分支下其他协作者已经先推送了代码;
- 你换了设备,在另一台电脑提交并推送到了同一个分支。
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 你的分支名
开发规范小结
- 多人协作原则:每次 push 之前先 pull,保持本地和远程同步;
- 主分支不要随便 force push,一旦覆盖别人提交,恢复成本很高;
- 优先用 pull /fetch + merge,强制推送永远是最后备选方案。
正文完
可以使用微信扫码关注公众号(ID:xzluomor)