git-flow 原理:A successful Git branching model,两篇不错的中文翻译: Git开发管理之道,一个成功的Git分支模型。
简单来说,git-flow 就是在 git branch
git tag
基础上封装出来的代码分支管理模型,把实际开发模拟成 master
develop
feature
release
hotfix
support
几种场景,其中 master
对应发布上线,develop
对应开发,其他几个在不同的情况下出现。通过封装,git-flow 屏蔽了 git branch
等相对来说比较复杂生硬的命令(git branch
还是比较复杂的,尤其是在多分支情况下),简单而且规范的解决了代码分支管理问题。
安装 git-flow:
在一个全新目录下构建 git-flow 模型:
1
2
3
4
5
6
7
8
9
10
11
12
|
➜ git flow init
Initialized empty Git repository in /Users/fannheyward/flowTest/.git/
No branches exist yet. Base branches must be created now.
Branch name for production releases: [master]
Branch name for "next release" development: [develop]
How to name your supporting branch prefixes?
Feature branches? [feature/]
Release branches? [release/]
Hotfix branches? [hotfix/]
Support branches? [support/]
Version tag prefix? []
|
或者在现有的版本库构建:
1
2
3
4
5
6
7
8
9
10
11
12
|
➜ git flow init
Which branch should be used for bringing forth production releases?
- master
Branch name for production releases: [master]
Branch name for "next release" development: [develop]
How to name your supporting branch prefixes?
Feature branches? [feature/]
Release branches? [release/]
Hotfix branches? [hotfix/]
Support branches? [support/]
Version tag prefix? []
|
中间会询问生成的分支名,直接回车默认。这样一个 git-flow 分支模型就初始化完成。
使用场景一:新功能开发,代号 f1
1
2
3
4
5
6
7
8
9
10
|
➜ git flow feature start f1
Switched to a new branch 'feature/f1'
Summary of actions:
- A new branch 'feature/f1' was created, based on 'develop'
- You are now on branch 'feature/f1'
Now, start committing on your feature. When done, use:
git flow feature finish f1
|
git-flow 从 develop
分支创建了一个新的分支 feature/f1
,并自动切换到这个分支下面。然后就可以进行 f1 功能开发,中间可以多次的 commit
操作。当功能完成后:
1
2
3
4
5
6
7
8
9
|
➜ git flow feature finish f1
Switched to branch 'develop'
Already up-to-date.
Deleted branch feature/f1 (was 7bb5749).
Summary of actions:
- The feature branch 'feature/f1' was merged into 'develop'
- Feature branch 'feature/f1' has been removed
- You are now on branch 'develop'
|
feature/f1
分支的代码会被合并到 develop
里面,然后删除该分支,切换回 develop
. 到此,新功能开发这个场景完毕。在 f1 功能开发中,如果 f1 未完成,同时功能 f2 要开始进行,也是可以的。
使用场景二:发布上线,代号 0.1
1
2
3
4
5
6
7
8
9
10
11
12
13
|
➜ git flow release start 0.1
Switched to a new branch 'release/0.1'
Summary of actions:
- A new branch 'release/0.1' was created, based on 'develop'
- You are now on branch 'release/0.1'
Follow-up actions:
- Bump the version number now!
- Start committing last-minute fixes in preparing your release
- When done, run:
git flow release finish '0.1'
|
git-flow 从 develop
分支创建一个新的分支 release/0.1
,并切换到该分支下,接下来要做的就是修改版本号等发布操作。完成后:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
➜ git flow release finish 0.1
Switched to branch 'master'
Merge made by the 'recursive' strategy.
f1 | 1 +
version | 1 +
2 files changed, 2 insertions(+)
create mode 100644 f1
create mode 100644 version
Switched to branch 'develop'
Merge made by the 'recursive' strategy.
version | 1 +
1 file changed, 1 insertion(+)
create mode 100644 version
Deleted branch release/0.1 (was d77df80).
Summary of actions:
- Latest objects have been fetched from 'origin'
- Release branch has been merged into 'master'
- The release was tagged '0.1'
- Release branch has been back-merged into 'develop'
- Release branch 'release/0.1' has been deleted
|
git-flow 会依次切换到 master
develop
下合并 release/0.1
里的修改,然后用 git tag
的给当次发布打上 tag 0.1,可以通过 git tag
查看所有 tag:
1
2
3
|
➜ git:(master) git tag
0.1
0.2
|
使用场景三:紧急 bug 修正,代号 bug1
1
2
3
4
5
6
7
8
9
10
11
12
13
|
➜ git flow hotfix start bug1
Switched to a new branch 'hotfix/bug1'
Summary of actions:
- A new branch 'hotfix/bug1' was created, based on 'master'
- You are now on branch 'hotfix/bug1'
Follow-up actions:
- Bump the version number now!
- Start committing your hot fixes
- When done, run:
git flow hotfix finish 'bug1'
|
git-flow 从 master
分支创建一个新的分支 hotfix/bug1
,并切换到该分支下。接下来要做的就是修复 bug,完成后:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
➜ git flow hotfix finish bug1
Switched to branch 'master'
Merge made by the 'recursive' strategy.
f1 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
Switched to branch 'develop'
Merge made by the 'recursive' strategy.
f1 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
Deleted branch hotfix/bug1 (was aa3ca2e).
Summary of actions:
- Latest objects have been fetched from 'origin'
- Hotfix branch has been merged into 'master'
- The hotfix was tagged 'bug1'
- Hotfix branch has been back-merged into 'develop'
- Hotfix branch 'hotfix/bug1' has been deleted
|
git-flow 会依次切换到 master
develop
分支下合并 hotfix/bug1
,然后删掉 hotfix/bug1
。到此,hotfix 完成。
git-flow 的 feature
release
都是从 develop
分支创建,hotfix
support
都是从 master
分支创建。
来源:http://fann.im/blog/2012/03/12/git-flow-notes/