一、背景
今天更新了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