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 方式，它能更优雅地处理分支同步问题。