Git 推送失败问题解决指南

当执行 `git push -u origin master` 时遇到类似以下错误： ```git error: failed to push some refs to 'http://xxxx.cn/vip/xxx.git' To http://xxxx.cn/vip/xxx.git ! refs/heads/master:refs/heads/master [rejected] (fetch first) Done 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. ``` 或简化版错误： ```git [rejected] master -> master (fetch first) error: failed to push some refs ``` 这是 Git 常见的版本冲突问题，原因是远程仓库存在本地没有的更新，为防止覆盖远程变更而拒绝推送。 ## 推荐解决方案 最简洁高效的处理方式是执行以下命令： ```bash # 拉取远程master分支并以rebase方式整合本地更改 git pull --rebase origin master # 完成整合后再次推送（-u参数会建立本地与远程分支的关联） git push -u origin master ``` 这种方式会： 1. 将远程最新更改下载到本地 2. 以线性方式重新应用你的本地提交 3. 建立本地与远程分支的关联关系 ## 备选解决方案（适用于复杂冲突） 如果遇到复杂的代码冲突，可使用标准合并流程： ```bash # 拉取远程更新并合并到本地 git pull origin master # 若出现冲突，编辑冲突文件后标记为已解决 git add <冲突的文件路径> # 提交合并结果 git commit -m "合并远程更新并解决冲突" # 推送本地更改 git push origin master ``` ## 注意事项 - `git pull --rebase` 会改写提交历史，保持提交记录更整洁 - 多人协作时，推送前先拉取是良好习惯 - 解决冲突时需仔细检查代码，确保逻辑正确 - 首次推送分支时，`-u` 参数只需使用一次，后续可直接用 `git push` 以上方法可解决绝大多数推送失败问题，推荐优先使用 `git pull --rebase` 方式，它能更优雅地处理分支同步问题。