产品快速迭代时用Git做分支管理的详细步骤

一、前言

本文用实例来讲解Git的分支管理在产品快速迭代开发过程中解决实际问题的详细方案,面向的是对Git有一定了解的朋友(多图预警)。


二、背景

最近接手了一个代码质量惨不忍睹的项目,立即着手进行重构,由于产品已经发布上线,在重构新版的过程中还要一直维护着老版本,所以如何维护好两个版本的代码就成了一个问题。由于我们的团队一直以来使用Git时都忽视了其最大的优势 - 分支管理,所以正好趁此机会规范团队中Git的使用姿势。


三、关键字提示

master指的是本地主分支,也就是我们新建项目首次关联到Git上的本地主分支;
origin/master指的是远程主分支,也就是我们新建项目首次提交到Git上的远程主分支;
HEAD指的是我们当前所开发的代码的版本指针,指向的是某个分支上的节点;
commit指的是在当前分支新建一个节点,保存当前的代码版本;
这四个是我下面要经常提到的关键字,其他的遇到了再另外解释;


四、引出问题

假设我们的产品版本A已经发布上线了,现在我们继续开发版本B,今天产品经理过来告诉你版本A有一个十万火急的Bug,这个时候我们肯定是想办法拿到版本A的代码去修复Bug,那么问题来了:

1、在拿版本A的代码时,如何去保存我们写到一半的版本B的代码?

有的朋友肯定会把写到一半的代码commit到本地去解决这个问题,这是最简单的方式但是也是错误的方式,其仅仅是达到了目的,但是这样会在版本节点上留下很多垃圾数据,经常会误导团队的其他成员。

2、在修改完版本A的Bug后,如何提交这次的修改呢?

版本A的节点上直接进行commit的话,HEAD指针会游离出去,也就是我们经常遇见的问题HEAD detached at head或者HEAD detached from master,搞不好会丢失一部分代码,如果你已经遇到这个问题了,这里只提供方案就是找到HEAD现在所指向的未知分支,给其命名,然后合并到master分支上,具体操作自行搜索。

3、先不管用什么办法,假如我在修改完版本A后真的将此次的修改记录成功提交了,如何恢复我写到一半的版本B 的代码呢?

这里一定有修改完后选择不提交,直接手动合并到版本B的朋友,目的又达到了,但是这样会导致此次对版本A的修改以未知的方式记录到版本B上去了,时间长了恐怕自己都不知道当初是改了哪里了。


五、解决方案

带着以上三个问题,我们进行情景再现,用Demo来演示一个项目在Git上的正确管理步骤。

  • 初始导入
    现在我们拿到了版本A的代码,将其提交到远程Git仓库上大家应该是没有问题的,从Android Studio的版本节点树可以看到,可以看到我们有了本地主分支master和远程主分支origin/masterHEAD指向的是本地的master分支。

  • 创建开发分支
    现在版本A已经发布,我们要进行版本B的开发了,这里最关键的是我们不可以在master主支上直接进行开发,master主支应当作为生产环境上的正式版本的发布分支,该分支的每个版本最好是有效的、干净的,原则上严禁对发布版本直接进行修改。所以我们需要一个开发分支,称为developer分支,这个分支用来专门开发新版本。
    现在我们从版本A创建出一个developer分支,在工作空间根目录cmd下执行:

    git branch developer master
    

    即从master创建developer的意思,版本树如下:

可以看到我们现在有了本地的developer分支,我们还要把该分支上传到远程仓库,执行
git push origin developer:developer
执行结果如下,意思是将本地的developer分支上传到远程origin/developer,如果远程不存在'origin/developer'分支,则新建之


为了便于观察,我在developer分支上提交了一个节点,现在观察版本树

  • 保存正在写的代码
    现在我们正在developer分支上改动代码,但是master分支出现了一个紧急的bug,我们应该执行git stash,作用是暂存我们在developer上做的没有提交的修改,然后我们执行
    git branch bugbranch master
    从master分支检出一个新的bug分支bugbranch,而不是直接切换到master分支上进行修改。现在观察版本树,可以看到从master分支分离出了bugbranch分支,现在HEAD指向的就是该分支。

  • 修复bug
    现在我们在bugbranch分支上修复了bug,并且测试通过了,那么接下来我们需要把修复后的代码commit一次,做一个节点保存记录一下,现在观察版本树

  • 合并bug分支
    bugbranch分支上我们已经修复了bug,那么我们需要将bugbranch分支上修复后的代码合并到master分支上去,做一个节点并且发布新版本,先切换到master分支git checkout master,然后执行
    git merge bugbranch
    bugbranch分支合并到master分支上,现在观察版本树

可以看到现在masterbugbranch分支上的代码已经合并成功一致,接下来还要将最新的代码push到远程分支上去,执行git push origin master:master,观察下边的版本树可以看到,现在本地和远程分支上的代码都已经更新完成,我们可以发布新版本了

  • 合并修复的bug到开发分支
    到了这里bugbranch分支的任务就完成了,我个人认为已经没有保留的必要了,因为本次修改的过程已经记录到了master的节点上,如果以后出了问题,再从当前节点重新检出一个分支就好,执行
    git branch -d bugbranch

删除bugbranch分支,现在bug已经修复并且发布,我们需要回到正常的开发分支上去继续开发新的功能,执行git checkout developer先切换到developer分支,然后执行
git stash pop
取出我们当时在developer分支上stash的未提交的代码,至于我们在master分支上修复的bug怎么更新到developer分支上,分两种情况处理:

1、如果该bug影响到新模块的开发,那就手动更新修复部分的代码,到时候新模块开发完成之后我们将developer分支合并回master的时候就会产生冲突,解决掉就好;

2、如果该bug对新模块的开发没影响,那就不用做处理,到时候将developer分支合并回master之后修复后的代码自然就更新了。

  • 合并开发分支到master
    现在我们developer分支上的新功能写完并且测试通过了,我们需要先将developer分支上的代码都提交到远程'developer'分支上,我们发布新版本的时候需要先将developer分支的代码合并到master分支上去,执行git checkout master切换到master分支,执行get merge developer来进行合并,这个时候可能会产生冲突,对照解决即可。

下面是developer分支向master合并的时候产生了冲突,解决掉合并后的版本树


接下来我们需要先将本地的master分支提交更新到远程,可以发现虽然developer分支虽然成功合并到master上了,但是因为产生了冲突,developer分支比master分支落后两个节点(分别是1.解决merge冲突的节点 2.当初修改的bug节点),也就意味着代码有了差别,如下图所示:

如果出现这种情况,需要再次执行get merge developer,再合并一次,这次冲突已经被解决了,直接合并成功,接下来我们直接将本地的developer分支代码提交到远程origin/developer分支即可,最终的代码树如下:

六、后言

在快速迭代开发中,经常会有需要紧急处理生产环境版本bug的时候,按照这样的分支管理操作,可以做到快速的拿到每一个发布版的代码;在开发新模块、修复旧bug、恢复旧版本的时候不互相污染代码;干净、清楚的记录每次更新、修复、迭代的内容。

从业以来的两个团队都没有一个成熟的git分支管理使用方案,这些处理方式是我在实际工作中摸索、总结出来的,是否跟真正正确的使用方式一致不太清楚,但是确实是解决掉我项目重构中实际遇到的问题了,感觉比较适合中小型团队使用,因为大团队我也没去过,有什么错误欢迎指出讨论,哈哈。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容