Feature Branches

• 来源：可能是 develop
• 终点：必须是 develop
• 命名规则：除了 master, develop, release-*, hotfix-* 之外，其他名字都可以

顾名思义，Feature 分支的目的就是为了开发新 feature，有时候开始开发新 feature 的时候并不知道最终 merge 回哪个 release 分支，只要开始开发这个 feature，那么该 feature 分支就会一直存在，直到最后 merge 回 develop 或者是丢弃掉（中途放弃开发）。

Feature 分支一般只存在于相关开发者的本地 repo 中，并不会存在 origin 上，除非是多和协作共同完成一个大 feature 的情况。

1. 创建 feature 分支

   1
   2

   // creating a new feature branch
   git checkout -b feature-xxx develop
   

2. 结束 feature 分支

   1
   2
   3
   4
   5

   // merge back to develop branch
   git checkout develop
   git merge --no-ff feature-xxx
   git branch -d feature-xxx
   git push origin develop
   

   用 --no-ff 来保留 branch 信息。

Release Branch

• 来源：可能是 develop
• 终点：必须是 develop & master
• 命名规则：release-*

Release 分支的作用是为最终产品发布做准备，在这个 branch 上允许做最后一刻的修改，比如微小的 bug 修改，为发布准备 meta-data（版本号，build 日期等等），在 release 分支上做这些事情的好处是可以保持 develop 分支的干净整洁。

创建 release 分支的时间点非常关键，主要有两方面的约束，

1. 不能太早，相关功能的代码要全部 ready：当前要发布的 release 包含的新 feature 必须都已经合入 develop 之中
2. 不能太晚，代码要防污染：不能包含下一次 release 对应的 feature 代码

约束 1 要求 develop 分支（几乎）完成了新 release 的所有功能才可以创建 release 分支。约束 2 要求未来下一次 release 的 feature 代码则一定不能合并进来，这些新 feature 必须等到创建当前 release 之后才能合进 develop 分支。

在创建了 release 分支之后，develop 分支就可以为 “ 下一次 release” 做准备了。

1. 创建 release 分支

   1
   2
   3

   git checkout -b release-1.2 develop
   ./bump-version.sh 1.2
   git commit -a -m "Bumped version number to 1.2"
   

   创建好的 release 分支可能会存在一段时间，这段时间内如果有 bug 修改，应该在 release 分支上，而不是 develop 上。新 feature 禁止直接加到 release 分支上，而是应该加到 develop 上，等待下一次的 release。

2. 结束 release 分支

   1
   2
   3
   4
   5
   6

   git checkout master
   git merge --no-ff release-1.2
   git tag -a 1.2
   git checkout develop
   git merge -no-ff release-1.2
   git branch -d release-1.2
   

   当 release 分支最终达到可以 release 状态的时候，需要做的事情有

   • 把 release 分支 merge 回 master（前面描述过，master 的每个结点都是一个 release 版本）
   • 给 master 分支打 tag，方便以后回溯版本
   • 把 release 分支 merge 回 develop 分支（保存 release 分支上的 bug 修改）

Hotfix Branches

• 来源：可能是 master
• 终点：必须是 develop & master
• 命名规则：hotfix-*

hotfix 分支的作用和 release 有点类似，也是为了新产品发布，但是它是计划之外的。hoftfix 是为了应对那种意外发现的，急待解决的产品 bug，如果发现产品上有一个马上就要解决的重大 bug，那么就可以从 master 的该节点上创建一个 hotfix 分支。

典型场景：

突然发现 master 分支上正在使用的产品版本（比如说是 release-1.2）有一个致命 bug，但是 develop 分支因为合入了新 feature，还没有稳定，不能直接在 develop 分支上进行修复，此时就需要创建一个 hotfix 分支。

由上面的例子可以看出，hotfix 分支存在的意义是让团队中的一部分人来进行快速的产品 fix，另外一部分人仍然按照计划进行开发，相互不影响。

1. 创建一个 hotfix 分支

   1
   2
   3

   git checkout -b hotfix-1.2.1 master
   ./bump-version.sh 1.2.1
   git commit -a -m "Bumped version number to 1.2.1"
   

   在修改完 bug 之后，把修改结果 commit

   1

   git commit -m "FIxed severe production problem"
   

2. 结束 hotfix 分支

   最后 bugfix 的内容除了要 merge 回 master，还要 merge 回 develop，以保证下一次 release 的时候这个 bug 已经被修复了。这个过程和结束 release 分支很类似。

   1
   2
   3
   4
   5
   6

   git checkout master
   git merge --no-ff hotfix-1.2.1
   git tag -a 1.2.1
   git checkout -b develop
   git merge --no-ff hotfix-1.2.1
   git branch -d hotfix-1.2.1
   

   有个特殊情况：如果存在一个 release 分支，那么应该将 hotfix 分支 merge 到 release 分支，而不是 develop 分支。Merge 到 release 的 bugfix 代码最终会随着 release 代码一起合入到 develop 分支中，不需要担心丢失。（如果 develop 分支需要马上就合入这个 bugfix，等不到 release 分支结束，那么也可以将 bugfix 合入到 develop 中。）

Install

1

sudo apt-get install git-flow

Setup

1

git flow init

回答一系列问题即可，推荐使用默认值

Features

1. 创建一个 feature 分支：

   • 基于 develop 创建了一个新 feature 分支，并切换过去

   1

   git flow feature start MYFEATURE
   

2. 结束一个 feature 分支：

   • 把 MYFEATURE 分支 merge 回 develop 分支
   • 删除该 feature 分支
   • 切换回 develop 分支

   1

   git flow feature finish MYFEATURE
   

3. 发布一个 feature

   1

   git flow feature publish MYFEATURE
   

   把 feature 分支发布到 remote 服务器，方便其他人使用

4. 获取一个其他人发布的 feature

   1

   git flow feature pull origin MYFEATURE
   

Release

1. 创建一个 release 分支

   1

   git flow release start RELEASE [BASE]
   

   通过一个可选项 [BASE] 来制定 develop 上的某个特定节点

2. 把 release 分支的结果发布给其他开发者

   1

   git flow release publish RELEASE
   

3. 结束一个 release 分支

   • 把 release 分支 merge 回 master 分支
   • 用 release 分支的名字给 master 打 tag
   • 把 release 分支 merge 回 develop 分支
   • 删除 release 分支

   1

   git flow release finish RELEASE
   

   别忘了把你的 tag push 到远程 repo：git push origin --tags

Hotfix

1. 创建一个 hotfix 分支

   1

   git flow hotfix start VERSION [BASENAME]
   

2. 结束一个 hotfix 分支

   • 把 hotfix 分支 merge 回 develop 和 master 分支
   • 用 hotfix 的 version 给 master 分支打 tag

   1

   git flow hotfix finish VERSION
   

Zsh Extension

zsh 里面有两个相关插件，

• git flow completion，自动补全
• git-flow，提供命令的各种 alias

给 zsh 安装 git flow completion 插件的步骤，

1. 1

   git clone https://github.com/bobthecow/git-flow-completion ~/.oh-my-zsh/custom/plugins/git-flow-completion
   

2. 更新 .zshrc 文件

   1

   plugins=(<some-plugin> <another-plugin> git-flow-completion)
   

3. 重新 source 之后就可以看到自动补全的效果了