【iOS开发笔记】git pull问题的解释和解决方案

一、背景

今天更新了SourceThree，更新后合并代码时遇到了以下问题

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 
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 参数覆盖缺省设置。

出现问题的主要原因应该是因为更新SourceThree时将git版本也一并更新了，查看后发现git版本为2.37.0。

二、相关知识

通过上面的问题提示，可以看到，主要涉及两个Git的配置信息pull.rebase和pull.ff。

1. pull.ff

当pull.ff为false时，相当于执行命令git pull --no-ff。这个变量告诉 Git 在这种情况下，如果执行不带选项的git pull命令时先尝试快进合并，如果不行再进行正常合并生成一个新的提交。
当pull.ff为only时，相当于执行命令git pull --ff-only。只允许快进合并，如果执行不带选项的git pull命令时，如果不能进行快进合并则终止当前操作。
如果将pull.ff设置为only，而执行不带选项的git pull命令被终止，其实可以使用带参数的git pull --no-ff或者git pull --rebase命令来执行pull操作。

2. pull.rebase

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

那么git pull命令的各个选项到底有什么意义呢？

3. git pull

git pull命令等价于：先执行git fetch，再执行git merge FETCH_HEAD将远程仓库对应分支的最新提交合并到当前本地分支中。
git fetch会查询git remote中所有的远程仓库所包含分支的最新提交，并将其记录到.git/FETCH_HEAD文件中。
.git/FETCH_HEAD是一个版本链接，指向着目前已经从远程仓库取下来的所有分支的最新提交。

4. git pull的选项及作用

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

综上所述，直接执行git pull时，Git不知道我们到底想要采用哪种合并策略来执行git pull，因此会出现最开始提到的问题，建议我们通过git config来进行基本设置，制定不带任何选项的git pull执行哪种策略。那么下面再讲一下Git的配置。

5. git的配置

5.1 三个配置等级

Git一共有三个配置文件，可以通过git config命令修改，它们的权重为1>2>3，会优先选择--local对应的配置策略进行。

仓库级配置文件--local
全局级配置文件--global
系统级配置文件--system

5.2 查看配置文件

查看配置文件的命令为-l或者采用--list。

查看仓库级的配置：git config --local -l
查看全局级的配置：git config --global -l
查看系统级的配置：git config --system -l
查看当前生效的所有配置：git config -l

5.3 编辑配置文件

编辑配置文件的命令为-e或者采用--edit。

编辑仓库级的配置：git config --local -e
编辑全局级的配置：git config --global -e
编辑系统级的配置：git config --system -e

5.4 新增一个配置项

新增配置项的命令为--add，默认添加在--local配置中。其中section.key为要添加的配置项，value是配置项的值。

新增仓库级的配置项：git config --local --add section.key value
新增全局级的配置项：git config --global --add section.key value
新增系统级的配置项：git config --system --add section.key value

5.5 获取一个配置项

获取配置项的命令为--get。

获取仓库级的配置项：git config --local --get section.key
获取全局级的配置项：git config --global --get section.key
获取系统级的配置项：git config --system --get section.key

5.6 删除一个配置项

删除配置项的命令为--unset。

删除仓库级的配置项：git config --local --unset section.key
删除全局级的配置项：git config --global --unset section.key
删除系统级的配置项：git config --system --unset section.key

6. 其他定义

偏离分支：当本地的分支落后于远程分支时，本地分支又自行修改项目文件生成了新的提交，这时本地分支再执行git pull命令就不能快进合并，并且还容易发生冲突。这时的本地分支便称为偏离分支，因为这时的本地分支的最新提交跟远程分支的最新提交不同，产生了偏离。
合并策略：合并策略便是git merge --ff-only、git merge --no-ff、git merge --rebase这三种常见的合并策略，分别代表着快进合并、非快进普通合并、变基合并。

三、解决问题

SourceThree的合并代码本质上也是git pull命令，通过上面的学习我们可以了解到，出现问题的原因就是因为git pull的歧义。因此，我们只需要在Git中配置pull.rebase或pull.ff的参数即可。

git config --global --add pull.rebase false