git-flow 備忘清單

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 專案中，並且以下列指令進行初始化:

git flow init

接著您必須回答幾個問題，是關於分支名稱的定義。
這裡建議使用預設值。

開始新功能設計

新功能的開發是由 'develop' 分支的最後一個版本發展出來的。

使用下列的命令可以開始一個新功能的分支：

git flow feature start MYFEATURE

這個命令將會於 'develop' 的最後一個版本建立出另一個 'feature/MYFEATURE' 分支，並自動切換至這個分支底下。現在你可以開始製作新功能。

完成新功能

當你在新功能分支完成新功能後，使用下列指令來結束新功能開發:

git flow feature finish MYFEATURE

這個指令會替你完成下列動作:

• 合並(Merge) MYFEATURE 分支回到 'develop'
• 刪除這個新功能分支
• 切換回 'develop' 分支

發佈新功能分支

你是否需多人合作開發新功能？
透過下列命令來發佈新功能分支到遠端 git 伺服器，讓其他使用者也能共用這個新功能分支。

git flow feature publish MYFEATURE

取得新功能分支

當你需接手完成新功能時，透過下列命令取得遠端伺服器上的新功能分支，並得到所有保存在遠端伺服器上的變更紀錄：

git flow feature pull MYFEATURE

开始准备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

开始 git flow 热点修复

像其它 git flow 命令一样, 热点修复分支开始自：

git flow hotfix start VERSION [BASENAME]

VERSION 参数标记着修正版本。你可以从 [BASENAME]开始，[BASENAME]为finish release时填写的版本号

完成热点修复

当完成热点分支，代码归并回 develop 和 master 分支。相应地，master 分支打上修正版本的 TAG。

git flow hotfix finish VERSION