相比同类软件,Git有很多优点。其中很显著的一点,就是版本的分支(branch)和合并(merge)十分方便。有些传统的版本管理软件,分支操作实际上会生成一份现有代码的物理拷贝,而Git只生成一个指向当前版本(又称"快照")的指针,因此非常快捷易用。

但是,太方便了也会产生副作用。如果你不加注意,很可能会留下一个枝节蔓生、四处开放的版本库,到处都是分支,完全看不出主干发展的脉络。

Vincent Driessen 提出了一个分支管理的 策略 ,我觉得非常值得借鉴。它可以使得版本库的演进保持简洁,主干清晰,各个分支各司其职、井井有条。理论上,这些策略对所有的版本管理系统都适用,Git只是用来举例而已。如果你不熟悉Git,跳过举例部分就可以了。

一、主分支Master

首先,代码库应该有一个、且仅有一个主分支。所有提供给用户使用的正式版本,都在这个主分支上发布。

Git主分支的名字,默认叫做Master。它是自动建立的,版本库初始化以后,默认就是在主分支在进行开发。

二、开发分支Develop

主分支只用来分布重大版本,日常开发应该在另一条分支上完成。我们把开发用的分支,叫做Develop。

这个分支可以用来生成代码的最新隔夜版本(nightly)。如果想正式对外发布,就在Master分支上,对Develop分支进行"合并"(merge)。

Git创建Develop分支的命令:

git checkout -b develop master

将Develop分支发布到Master分支的命令:

# 切换到Master分支
git checkout master

# 对Develop分支进行合并
git merge --no-ff develop

这里稍微解释一下,上一条命令的--no-ff参数是什么意思。默认情况下,Git执行"快进式合并"(fast-farward merge),会直接将Master分支指向Develop分支。

使用--no-ff参数后,会执行正常合并,在Master分支上生成一个新节点。为了保证版本演进的清晰,我们希望采用这种做法。关于合并的更多解释,请参考Benjamin Sandofsky的 《Understanding the Git Workflow》

三、临时性分支

前面讲到版本库的两条主要分支:Master和Develop。前者用于正式发布,后者用于日常开发。其实,常设分支只需要这两条就够了,不需要其他了。

但是,除了常设分支以外,还有一些临时性分支,用于应对一些特定目的的版本开发。临时性分支主要有三种:

* 功能(feature)分支

* 预发布(release)分支

* 修补bug(fixbug)分支

这三种分支都属于临时性需要,使用完以后,应该删除,使得代码库的常设分支始终只有Master和Develop。

四、 功能分支

接下来,一个个来看这三种"临时性分支"。

第一种是功能分支,它是为了开发某种特定功能,从Develop分支上面分出来的。开发完成后,要再并入Develop。

功能分支的名字,可以采用feature-*的形式命名。

创建一个功能分支:

git checkout -b feature-x develop

开发完成后,将功能分支合并到develop分支:

git checkout develop

git merge --no-ff feature-x

删除feature分支:

git branch -d feature-x

五、预发布分支

第二种是预发布分支,它是指发布正式版本之前(即合并到Master分支之前),我们可能需要有一个预发布的版本进行测试。

预发布分支是从Develop分支上面分出来的,预发布结束以后,必须合并进Develop和Master分支。它的命名,可以采用release-*的形式。

创建一个预发布分支:

git checkout -b release-1.2 develop

确认没有问题后,合并到master分支:

git checkout master

git merge --no-ff release-1.2

# 对合并生成的新节点,做一个标签
git tag -a 1.2

再合并到develop分支:

git checkout develop

git merge --no-ff release-1.2

最后,删除预发布分支:

git branch -d release-1.2

六、修补bug分支

最后一种是修补bug分支。软件正式发布以后,难免会出现bug。这时就需要创建一个分支,进行bug修补。

修补bug分支是从Master分支上面分出来的。修补结束以后,再合并进Master和Develop分支。它的命名,可以采用fixbug-*的形式。

创建一个修补bug分支:

git checkout -b fixbug-0.1 master

修补结束后,合并到master分支:

git checkout master

git merge --no-ff fixbug-0.1

git tag -a 0.1.1

再合并到develop分支:

git checkout develop

git merge --no-ff fixbug-0.1

最后,删除"修补bug分支":

git branch -d fixbug-0.1

引用老赵的发言:

阮兄,说句题外话。你的版式似乎对阅读器的支持不是很好,例如Safari的Reader,经过实验估计是p元素太多,但没有突出文章主体,话说只要把文章内容放在article标签里就好了。

另外可以考虑使用 h1/h2 这些来区分标题,而不是单纯加粗,使用 pre 替换 block 来表示代码,block 是表示引用的。

我有个问题关于远程master权限读写的问题。因为远程master默认谁都可以往上push,这对于一个正式发布版本来说肯定不允许的,哪怕是误操作。于是在gitlab上可以设置保护远程master分支不被普通开发人员push,这样一来本地master岂不是形同虚设,因为本地develop也会是push到远程dev分支,最后由主程序员或项目组长来线上merge dev到master?不知道是不是这样的流程。

而且现在远程master普通开发人员不可写,这样一来本地hotfix临时分支就无法更新到远程master,而develop分支上又有新的功能在开发,这可如何是好?

引用Sean的发言:

我有个问题关于远程master权限读写的问题。因为远程master默认谁都可以往上push,这对于一个正式发布版本来说肯定不允许的,哪怕是误操作。于是在gitlab上可以设置保护远程master分支不被普通开发人员push,这样一来本地master岂不是形同虚设,因为本地develop也会是push到远程dev分支,最后由主程序员或项目组长来线上merge dev到master?不知道是不是这样的流程。

而且现在远程master普通开发人员不可写,这样一来本地hotfix临时分支就无法更新到远程master,而develop分支上又有新的功能在开发,这可如何是好?

第一个问题:
feature分支是基于develop分支的,bugfix有的地方叫hotfix分支基于master分支。发布时,基于develop分支创建预发步分支release-x,由release分支合并到master, 也就是说 develop 分支和master分支之间还有个 预发布分支 release分支。

第二个问题:
“假设功能分支1已经开发完成,准备合入develop进入测试,如果测试发现问题很多” 这句话说明单元测试和集成测试没有做好,才会出现快要提交develop-->release测试时候发现 “问题很多”, 建议交给测试之前先写好单元测试。并测试通过再考虑测试。

请问博主,预发布分支的tag和fixbug的tag如何管理?
预发布成功,tag1.2。但是后来修改bug成功,tag应该是1.2.1?1.3?还是不沿用预发布分支的tag版本号。
希望帮忙解答,多谢。

对于你的这个例子我的理解是软件开发上线周期是固定的,如果feature1, feature2都要赶上接下来的上线时间点上线,那么预发布是应该在feature1,feature2全部合并到dev后进行测试使用的,这个时候本来就是期望能够尽早发现bug并修复,所以并无互相拖延说法。如果其中一个feature开发进度比较慢会影响正常的升级时间,应该评估是否放弃这个上线时间点上线,考虑延后一个上线时间点上线。

P.S. 一般来说feature1,feature2是相互独立的功能,可以考虑在合并到dev之前先自测。
P.S. 软件就像一直前进的地铁,地铁里的每个乘客就像是软件的一个功能,每个站台(上线时间点)乘客有上有下,赶不上这趟就赶下趟,不能因为你一个人耽误了所有人的时间

问个问题,假设我的git库有两个分支master 和test, 在test分支上打了tag 比如v0.1, 然后又做了其他修改,现在我要合并master分支和test分支上的v0.1这个版本的代码,怎么合并?
我试过先在test上checkout到v0.1这个版本,然后再checkout到master上合并,结果还是合并的test分支的head,而不是v0.1这个版本。谢谢!

如大神所言,master和develop分支甚是关键。其余皆可作为临时性分支,包括功能性,Bug,预发。
个人实践:单人开发,三套环境。因此临时性分支包括3个:dev、preview、release

多人协作开发:项目前期,3个人,没人以自己姓名命名分支。同步代码要合并到master

阮老师,我刚使用git不久,看了您的文章非常受用,有一个疑问想请教您。如果在release0.1发现了一个bug,该如何处理?我的想法是从develope创建一个fixbug-1分支,修改bug后合并到develope分支,然后在develope分支重新创建release0.1.1用于做测试的预发布版本。但是,我所担心的是在发布release0.1后develope又被合并了其它分支例如feature-z,那么我checkout的fixbug-1就包含了feature-z的代码,这部分代码还会被保留到release0.1.1,而feature-z并不是我想要的在release0.1.*中发布的功能。

这种情况可以创建自定义的 merge driver,在 dev 被 merge 到 master 的时候可以保留 master 分支修改的内容。

1、注册 merge driver

注册好的 driver 会像一个过滤器一样在 merge 的时候自动执行。

```bash
# 全局注册自定义 merge driver
git config --global merge.ours.driver true

2、设置过滤项

```bash
# .gitattributes 文件(位于项目根目录)
project.config.json merge=ours
fetch.js merge=ours
app.js merge=ours

注意: 只能 master 合并其他分支时忽略其他分支上的文件, 其他分支合并 master 无法忽略 master 上的文件,所以这样的操作只能是单向有效。

3、正常的 merge 操作

```bash
git co master
git merge --no-ff dev

我的详细文章: https://github.com/yanyue404/blog/issues/180