前一篇介绍了 git相关的概念,我们可以查看文件的状态,在各个状态之间进行切换,可以创建和合并分支,通过rebase还可以整理自己的提交历史。通过这些命令和操作,就可完成工作流规范规定的操作流程了。
本篇介绍具体的规范,包括分支的划分和命名规范,不同类型的分支应对不同的场景,然后会介绍下工作流工具git-flow,如何简化我们的操作。
分支构成
master和develop分支一直存在,且名称不会变化,一般不直接修改这2个分支,由其他分支合并而来。
feature、release、hotfix分别用于功能点开发、优化,特定版本测试,线上问题紧急处理,同一类型的分支会产生多个。
分支划分如下:
- master:与线上版本保持绝对一致;
- develop:开发分支,由下文提到的release、feature、hotfix分支合并过后的代码;
- feature:实际功能点开发分支,建议每个功能新建一个feature, 具有关联关系的功能公用一个feature分支;
- release:每一次开发完成之后,从develop创建出来的分支,以此分支为基准,进行测试;
- hotfix:该分支主要用于修复线上bug;
命名规范约定如下:
- feature分支命名:feature/name
- release分支命名:release/name
- hotfix分支命名:hotfix/name
比如有一个「优化分布式Session」的需求,可在develop分支的基础上创建新分支 feature/optimize_distributed_session进行开发,开发完成后合并到develop分支。
分支详细介绍和处理流程
master分支
主分支,与线上运行的版本始终保持一致,任何时候都不要直接修改master分支。
一个版本的release分支、hotfix分支开发完成后,会合并代码到master分支,也就是说master分支主要来源于release分支和hotfix分支。
develop分支
开发分支,始终保持最新完成以及bug修复后的代码,新增功能时基于该分支创建feature分支。
一个版本的release分支、hotfix分支开发完成后,也会合并到develop分支,另外,一个版本的feature功能开发完成后,也会合并到develop分支。也就是说develop分支来源于feature、release、hotfix分支。
feature分支
开发新功能或优化现有功能时,会创建feature分支,以develop为基础创建。一般会有多个功能同时开发,但上线时间可能不同,在适当的时候将特定的feature分支合并到develop分支,并创建release分支,进入测试状态。
release分支
当一组feature开发完成,会首先合并到develop分支,开始进入提测阶段时,会创建release分支。
以release分支代码为基准提测,测试过程中若存在bug需要修复,则直接由开发者在release分支修复并提交。
测试完成之后,合并release分支到master和develop分支,此时master为最新代码,用作上线。
hotfix分支
线上出现紧急问题时,需要及时修复,以master分支为基线,创建hotfix分支,修复完成后,需要合并到master分支和develop分支。
特殊情况处理和注意点
develop分支已存在未上线的feature代码, 此时需要紧急上线一个新功能, 但develop的代码不能上,如何处理 ?
- 以master为基线创建feature, 在完成之后,代码合并到master分支;
- 为了保证develop是最新代码,需要从master合并到develop分支;
以develop为基线,创建了f1和f2两个feature分支之后, f1,f2开发一半的时候,发现两个分支代码需要有依赖怎么办 ?
- 最好在开发开始前确定两个功能是否相关,若相关则只创建一个分支,两个功能在一起开发;
- 如果已经创建,则需要合并到一个分支;
一定要保证commit历史记录的整洁,代码合并时,根据情况选择merge或rebase;
使用rebase注意,一旦分支中的提交对象发布到公共仓库,就千万不要对该分支进行衍合操作;
提交说明规范:
- 提交说明最好限制在一行以内,50个字符以下,简明扼要地描述更新内容,空开一行后,再展开详细注解;
- 如果关联jira,写上jira地址;
git-flow工具
上面的流程在第一次接触时,会觉得有点复杂,通过git-flow工具可以把这些流程自动化。它是一个命令行工具,支持各个平台,比如OSX、Linux、Windows等支持。
初始化
通过 git flow init 命令进行初始化,以交互式的方式进行,主要是约定分支的命名,建议使用默认值;
开发新功能
git flow feature start f1 添加新特性,这个操作创建了一个基于develop的特性分支,并切换到这个分支之下。
git flow feature finish f1 完成新特性,这个操作会合并f1分支到develop分支,并删除特性分支,切换回develop分支。
git flow feature publish f1 发布新分支,发布新特性分支到远程服务器,其它用户也可以使用这分支。
发布版本
git flow release start r1 [BASE] 创建发布版本,[BASE]是以哪个分支或commit为基础进行发版,一般为develop。
git flow release publish r1 发布release分支,其他同事就可以看到这个分支,并修改一些小问题。
git flow release finish r1 完成release分支,会合并release分支到master分支,用release分支名打Tag,合并release分支到 develop分支,最后移除release分支。
修复线上问题
有可能需要修正 master 分支上某个 TAG 标记的生产版本。
git flow hotfix start VERSION [BASENAME] 创建hotfix分支,VERSION 参数标记着修正版本,[BASENAME]为finish release时填写的版本号。
git flow hotfix finish VERSION,当完成紧急修复分支,代码合并到develop和 master分支。相应地,master分支打上修正版本的 TAG。
欢迎扫描下方二维码,关注我的个人微信公众号 ~
![情情说](https://i-blog.csdnimg.cn/blog_migrate/3228968f02a9838081a19e52299be460.webp?x-image-process=image/format,png)