什麼是 git-flow ?
git-flow 是一個 git 擴充功能,依照 Vincent Driessen 的分支模型提供高層次的倉庫控制方式。 查看更多
★ ★ ★
這個備忘清單將會為您展示 git-flow 的基本操作方式與結果。
★ ★ ★
基礎建議
- Git flow 提供了極為出色的指令與輸出提示。請仔細閱讀並觀察發生了什麼事情...
- SourceTree 是一個極為出色的 git 圖形介面應用程式,以內建了 git-flow 的功能。(支援 Mac OS X 與 Windows)
- Git-flow 是一個以歸並(Merge)為基底的解決方案,它並無提供重置(rebase)特性分支的功能。
★ ★ ★
安裝
- 你需要有一個已經初始化的 git 倉庫。
- Git flow 可以在 OSX, Linux 和 Windows 之下使用。
★ ★ ★
Mac OS X
透過 Homebrew 安裝$ brew install git-flow透過 Macports 安裝
$ port install git-flow
Linux
$ apt-get install git-flow
Windows (Cygwin)
$ wget -q -O - --no-check-certificate https://github.com/nvie/gitflow/raw/develop/contrib/gitflow-installer.sh | bash
在 Windows 下安装 git-flow, 你會需要 wget 和 util-linux。
更詳細的 git flow 安裝指南,請參閱 git flow wiki.

開始 git flow
在開始使用 git flow 之前,你必須完成一些簡單的設定。
★ ★ ★
初始化
開始使用 git-flow 前,你必須切換目錄至你的 git 專案中,並且以下列指令進行初始化:
git flow init
接著您必須回答幾個問題,是關於分支名稱的定義。
這裡建議使用預設值。
特性
- 为即将发布的版本开发新功能特性。
- 这通常只存在开发者的库中。
★ ★ ★
增加新特性
新特性的开发是基于 'develop' 分支的。
通过下面的命令开始开发新特性:
git flow feature start MYFEATURE
这个操作创建了一个基于'develop'的特性分支,并切换到这个分支之下。
完成新特性
完成开发新特性。这个动作执行下面的操作.
- 合并 MYFEATURE 分支到 'develop'
- 删除这个新特性分支
- 切换回 'develop' 分支
git flow feature finish MYFEATURE
发布新特性
你是否合作开发一项新特性?
发布新特性分支到远程服务器,所以,其它用户也可以使用这分支。
git flow feature publish MYFEATURE
取得一个发布的新特性分支
取得其它用户发布的新特性分支,并签出远程的变更。
git flow feature pull MYFEATURE
作一个release版本
- 支持一个新的用于生产环境的发布版本。
- 允许修正小问题,并为发布版本准备元数据。
★ ★ ★
开始准备release版本
开始准备release版本,使用 git flow release 命令.
它从 'develop' 分支开始创建一个 release 分支。git flow release start RELEASE [BASE]
你可以选择提供一个 [BASE]
参数,即提交记录的 sha-1 hash 值,来开启动 release 分支. 这个提交记录的 sha-1 hash 值必须是'develop' 分支下的。
★ ★ ★
创建 release 分支之后立即发布允许其它用户向这个 release 分支提交见容是个明智的做法。命令十分类似发布新特性:
git flow release publish RELEASE
(你可以通过 git flow release track RELEASE
命令签出 release 版本的远程变更)
完成 release 版本
完成 release 版本是一个大 git 分支操作。它执行下面几个动作:
- 归并 release 分支到 'master' 分支
- 用 release 分支名打 Tag
- 归并 release 分支到 'develop'
- 移除 release 分支
git flow release finish RELEASE
热点修复
- 热点修复来自这样的需求:生产环境的版本处于一个不预期状态,需要立即修正。
- 有可能是需要修正 master 分支上某个 TAG 标记的生产版本。
★ ★ ★
开始 git flow 热点修复
像其它 git flow 命令一样, 热点修复分支开始自:
git flow hotfix start VERSION [BASENAME]
VERSION 参数标记着修正版本。你可以从 [BASENAME]开始,[BASENAME]
为finish release时填写的版本号
完成热点修复
当完成热点分支,代码归并回 develop 和 master 分支。相应地,master 分支打上修正版本的 TAG。
git flow hotfix finish VERSION
Backlog
★ ★ ★
- 并非所有可用的命令都涵盖在这里,这里包含有最重要的部分命令。
- 你依旧可以继续使用你所知道和了解的 git 命令, git flow 只是一个工具集合。
- 'support' 功能只是测试版本, 不建议使用
- 如果你乐意提供翻译,我很乐意整合它。
★ ★ ★