Git 详细规范

 

流程

描述

目前有主分支masterbranch和开发分支develop branch，主分支和开发分支是受保护的，开发者不能直接对其进行开发工作。只有项目管理者（通常是项目发起人）能对其进行较高权限的操作。

协同开发过程中开发者的工作流程是先将远程库克隆到本地，然后基于开发分支创建一个功能分支，进行相应的功能开发后提交并推送到远程库。以下是具体步骤，包含命令行

 

主分支Master

 

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

 

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

 

 

开发分支Develop

 

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

 

 

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

 

 

临时必分支

前面讲到版本库的两条主要分支：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

 

 

实例

步骤1：程序员

git clone git@mygitlabold.sytes.net:root/testc01.git  //从管理员那里克隆项目

 

cd testc01 //进入项目工作

 

git checkout -b swkFeature1 //创建自己的分支，并切换到此分支上，分支的命名规则为开发人员名字+所开发的功能名字。本例中命名为swk.feature1

 

vim aa.html //写了一个名为aa的html文件

 

git add aa.js //加入跟踪

 

ggit commit -am "swkFeature1 is ready" //提交

 

git push origin swkFeature1 //推送到远程服务器程序员个人分支上，git提示推送成功

 

git push origin swkFeature1:master //程序员想尝试直接推送到受保护的分支上，程序员是没有这个权限的，但是git提示为推送失败

 

 

步骤2：管理员

管理员对要求合并的分支代码进行审核。

管理员从服务器上获取程序员提交的分支。

git fetch

 

然后程序员推送的远程新分支被管理员拉拽到本地，但是不是以本地分支存在，

而是保存在.git/refs/heads 之外（.git/refs/remotes/origin/之中）的远程分支。

管理员可以如下方法对程序员的分支进行审核。

执行

git log master..origin/swkFeature1 //可以看到程序员推送了几个提交。

 

管理员可以合并程序员的分支：

git merge origin/swkFeature1

管理员可以逐一对孙悟空的提交审核。如果发现有问题，管理员可以本地回滚。

git reset --hard HEAD^ # 或 master@{1}

几个反复后，当程序员的分支审核无误，管理员将合并后的本地 master 分支推送到远程服务器：

git push # 缺省 remote 为 origin

 

 

步骤3：程序员

程序员看到请求已经接受。

 

执行 git fetch 会获取到更新的master 分支。然后

 

git checkout master

git merge --ff origin/master

swkFeature1分支完成使命，删掉吧：

git branch -d swkFeature1

git push origin :feature-ivanBanner # 删除远程分支

 

 

为了方便开发，我写了几个自动shell脚本：

path: /bin/*

 

devcovishop.sh name# 开发环境代码更新脚本

 

prodcovishop.sh tag name # 生产环境发布脚本

 

featurecovishop.sh version name #新需求脚本

 

fixcovishop.sh version name #fix bug 脚本