Git 推送代码提示 failed to push some refs to ‘xxx.git‘

1. 问题详情

登录并使用 Github 创建远程仓库并将创建好的远程仓库通过 git 命令

git remote add

和本地仓库关联绑定后使用 git 提交时出现该错误。该该问题提示内容均为

error: failed to push some refs to 远程仓库地址

，例如

error: failed to push some refs to '[email protected]:xiaoming/hello.git

2. 问题原因

我们在使用 Github 创建远程仓库的时候，勾选了 使用 Reamdme 文件初始化这个仓库 选项，该选项在创建远程仓库时会自动生成 README 文件 并配置 .gitignore 忽略文件，同时 Github 会自动帮助我们做一次初始提交。完成后我们的远程仓库中就有了

README.md

和

.gitignore

文件。
然后我们把本地仓库关联到该远程仓库，并把本地仓库内容推送到远程仓库时出现该错误，这时查看 git 报告的详细错误中总是要求我们先拉取远程仓库再推送，但是执行拉取命令

git pull origin master

拉取远程仓库总是失败。
总是拉取失败是因为我们在关联本地与远程时，两端都是有内容的，但是这两份内容并没有联系，当我们推送到远程或者从远程拉取内容时，无论对于远程还是本地仓库来说都会存在没有被跟踪的内容（对于本地来说远程存在本地仓库没有跟踪的 README.md 和 .gitignore，对于远程来说本地存在远程没有跟踪的用户新增或修改的文件）。

3. 解决办法

首先在 Git 命令行工具中执行

git pull --rebase origin master

命令来拉取远程仓库内容。
再 Git 命令行工具中执行

git push -u origin master

命令来推送本地仓库内容。

注意：

git pull

等同于

git fetch + git merge

git pull --rebase

等同于

git fetch + git rebase

所以可以知道这两种命令的差异点在于

git merge

和

git rebase

git merge

将远端

master

分支的代码和本地的代码在新增的节点合并，之前的提交会分开去显示。

git --rebase

会将两个分支融合成一个线性的提交，不会形成新的节点。

在

rebase

的过程中可能出现冲突，这时 Git 会停止 rebase 并让我们解决冲突，解决冲突后再次提交代码，用

git add

命令去更新解决冲突后的内容，不用执行

git-commit

命令直接执行

git rebase --continue

这样Git 会继续 apply 余下的补丁。

4. 建议

在 **Github ** 创建远程仓库时不要勾选 Add a README file 以及 .gitignore 和 license 这些文件。