git-pull-default

问题背景

当使用 git 版本为 2.27.0 以上时，使用git pull命令出现以下的警告：

hint: Pulling without specifying how to reconcile divergent branches is
hint: discouraged. You can squelch this message by running one of the following
hint: commands sometime before your next pull:
hint:
hint:   git config pull.rebase false  # merge (the default strategy)
hint:   git config pull.rebase true   # rebase
hint:   git config pull.ff only       # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.

该警告的中文版本文案描述如下：

warning: 不建议在没有为偏离分支指定合并策略时执行pull操作。
您可以在执行下一次pull操作之前执行下面一条命令来抑制本消息：

git config pull.rebase false  # 合并（默认缺省策略）
git config pull.rebase true   # 变基
git config pull.ff only       # 仅快进

您可以将 "git config" 替换为 "git config --global" 以便为所有仓库设置
缺省的配置项。您也可以在每次执行 pull 命令时添加 --rebase、--no-rebase，
或者 --ff-only 参数覆盖缺省设置。

解决方案

先说结论：

若无特殊需求执行：git config pull.rebase false(默认)

如何解决问题

在上述的警告文案描述中我们可以发现两个重要的 Git 配置信息pull.rebase和pull.ff。

pull.ff

先来了解一下pull.ff

在《Git 官方文档-参考-pull.ff》文章中可以查看到它的定义：

• 当把pull.ff设置为false时，这个变量告诉 Git 在这种情况下(相当于执行命令git pull --no-ff)，如果执行不带选项的git pull命令时先尝试快进合并，如果不行再进行正常合并生成一个新的提交。

• 当把pull.ff设置为only时，只允许快进合并(相当于执行命令git pull --ff-only)，如果执行不带选项的git pull命令时，如果不能进行快进合并则终止当前操作。

如果将pull.ff设置为only，而执行不带选项的git pull命令被终止，其实可以使用带参数的git pull --no-ff或者git pull --rebase命令来执行pull操作。

pull.rebase

在《Git 官方文档-参考-pull.base》文章中可查看pull.rebase的定义，此处只解释当选项pull.rebase的参数为true或者false时的定义：

• 当pull.rebase为 true 时，运行不带选项的命令git pull相当于执行git pull --rebase。
• 当pull.rebase为 false 时，运行不带选项的命令git pull不会被改变含义，即不会变基。如果想变基，需要在执行命令时显式地加上选项--rebase，即git pull --rebase。

理解git pull命令的原理及其各选项的含义

git pull命令的原理

git fetch会查询git remote中所有的远程仓库所包含分支的最新提交，并将其记录到.git/FETCH_HEAD文件中。

.git/FETCH_HEAD是一个版本链接，指向着目前已经从远程仓库取下来的所有分支的最新提交。

git pull命令等价于：先执行git fetch，再执行git merge FETCH_HEAD将远程仓库对应分支的最新提交合并到当前本地分支中。

git fetch && git merge

git pull命令中各选项的含义

git pull常见的选项搭配：

• 不带任何选项的git pull命令：先尝试快进合并，如果不行再进行正常合并生成一个新的提交。
• git pull --rebase命令：先尝试快进合并，如果不行再进行变基合并。
• git pull --ff-only命令：只尝试快进合并，如果不行则终止当前合并操作。
• git pull --no-ff命令：禁止快进合并，即不管能不能快进合并，最后都会进行正常合并生成一个新的提交。

理解git pull命令出现问题的原因

执行不带任何选项的git pull命令时，会产生三种歧义： git pull --ff-only、git pull --no-ff、git pull --rebase，而这三种 pull 方式的合并策略差异很大，即对整个分布式项目的版本管理有很大的影响作用。

而我们执行不带任何选项的git pull命令时，Git 就不知道我们到底想用哪种合并策略来执行git pull，因此 Git 会给出上述的警告文案，建议我们通过git config命令指定不带选项的git pull命令应该按照这三种合并策略的哪种来执行。

解决问题

再次回顾问题描述：

warning: 不建议在没有为偏离分支指定合并策略时执行pull操作。
您可以在执行下一次pull操作之前执行下面一条命令来抑制本消息：

git config pull.rebase false  # 合并（默认缺省策略）
git config pull.rebase true   # 变基
git config pull.ff only       # 仅快进

您可以将 "git config" 替换为 "git config --global" 以便为所有仓库设置
缺省的配置项。您也可以在每次执行 pull 命令时添加 --rebase、--no-rebase，
或者 --ff-only 参数覆盖缺省设置。

首先理解什么是偏离分支：

当本地的分支落后于远程分支时，本地分支又自行修改项目文件生成了新的提交，这时本地分支再执行git pull命令就不能快进合并，并且还容易发生冲突。这时的本地分支便称为偏离分支，因为这时的本地分支的最新提交跟远程分支的最新提交不同，产生了偏离。

接着理解什么是合并策略：

合并策略便是 git merge --ff-only、git merge --no-ff、git merge --rebase这三种常见的合并策略，分别代表着快进合并、非快进普通合并、变基合并。

通过上述的解析，现在我们理解了为什么理解git pull命令出现问题的原因，因此只要我们在 Git 中配置选项pull.rebase或pull.ff的参数即可。配置后，即便我们再执行不带任何选项的git pull命令，也不会再出现上述的警告文案啦。

若无特殊需求执行：git config pull.rebase false(默认)

参考链接

• Git 问题解决：warning: Pulling without specifying how to reconcile divergent branches is discouraged.
• Git 问题解决方案:不建议在没有为偏离分支指定合并策略时执行 pull 操作(Pulling without specifying how to reconcile divergent branches)
• git 合并操作总结