Git Flow 工作流完整指南：分支模型、實戰操作與自動化工具

什麼是 Git Flow？

**Git Flow** 是 Vincent Driessen 提出的**基於分支模型的發布管理策略**。它為不同分支分配嚴格角色，定義清晰的交互規則，適合**有明確發布週期、多版本並行維護、團隊協作規模較大**的項目。雖比 GitHub Flow 等輕量流程複雜，但提供了強大的結構化保障。

核心分支模型：五類分支，各司其職

標準工作流程圖解

1. 初始化：`master` 創建 `develop`。
2. 功能開發：從 `develop` 切 `feature` → 開發 → 合回 `develop`。
3. 發布準備：從 `develop` 切 `release` → 測試/修 Bug/改版本號 → 合入 `master` (打 Tag) + 合回 `develop` → 刪除 `release`。
4. 線上熱修：從 `master` 切 `hotfix` → 修復 → 合入 `master` (打新 Tag) + 合回 `develop` → 刪除 `hotfix`。

實戰命令操作手冊

1. 初始化倉庫

# 本地創建 develop 並推送
git branch develop
git push -u origin develop

# 團隊成員克隆並追蹤 develop
git clone 
git checkout -b develop origin/develop

或使用 Git Flow 工具一鍵初始化（自動創建所有分支並配置前綴）：

git flow init
# 交互式設置前綴：feature/, release/, hotfix/, support/, version tag prefix
# 完成後自動切換到 develop 分支

2. 功能開發

# 開始新功能
git flow feature start user-login
# 等價於：git checkout -b feature/user-login develop

# 開發過程：正常 add/commit
git add . && git commit -m "實現登錄邏輯"

# 推送到遠程協作/備份
git flow feature publish user-login
# 等價於：git push origin feature/user-login

# 同事拉取協作
git flow feature pull origin user-login

# 完成功能：合併回 develop，刪除本地/遠程 feature 分支
git flow feature finish user-login
# 內部執行：
# git checkout develop
# git merge --no-ff feature/user-login  # --no-ff 保留功能分支歷史
# git branch -d feature/user-login
# git push origin develop
# git push origin --delete feature/user-login

關鍵點：`--no-ff` 合併保留功能分支拓撲，便於回滾與審查歷史。

3. 版本發布

# 從 develop 切出版本分支
git flow release start v1.2.0
# 等價於：git checkout -b release/v1.2.0 develop

# 發布分支上：只修 Bug、改版本號、更新文檔、生成構建腳本
# 修復發布阻塞 Bug
git commit -am "修復登錄頁報錯"

# 完成發布：合入 master 打 Tag，合回 develop，刪除 release 分支
git flow release finish v1.2.0
# 內部執行：
# git checkout master
# git merge --no-ff release/v1.2.0
# git tag -a v1.2.0 -m "Release v1.2.0"
# git checkout develop
# git merge --no-ff release/v1.2.0
# git branch -d release/v1.2.0
# git push origin master develop --tags

# ⚠️ 記得推送標籤！
git push --tags

4. 緊急熱修復

# 從 master 切出熱修分支
git flow hotfix start v1.2.1
# 等價於：git checkout -b hotfix/v1.2.1 master

# 修復 Bug
git commit -am "修復支付金額計算錯誤"

# 完成熱修：合入 master 打新 Tag，合回 develop
git flow hotfix finish v1.2.1
# 內部類似 release finish，合入 master + develop 並打標籤
# 記得 git push --tags

Git Flow 工具命令速查表

最佳實踐與避坑指南

• 保持 `master` 純淨：只接受 `release`/`hotfix` 合併提交，每個提交對應一個生產版本 Tag。
• 功能分支短命化：功能拆解到 1-2 天可完成，避免長期分支導致合併地獄。
• CI/CD 集成：`develop` 推送觸發自動測試/構建快照；`master` 推送/Tag 觸發生產部署流水線。
• Code Review 機制：`feature finish` / `release finish` / `hotfix finish` 前通過 Pull Request/Merge Request 強制審查。
• 版本號規範：遵循 SemVer (主版本.次版本.修訂號)，Tag 格式 `v..`。
• 不要手動刪除遠程分支忘記推送：`git flow finish` 會自動處理本地/遠程刪除，手動操作易遺漏。
• 不適用場景：持續部署/單版本維護/極小團隊 → 改用 GitHub Flow (`main` + 短命 `feature` + PR) 或 GitLab Flow (`main` + `pre-prod`/`production` 環境分支)。

結語

Git Flow 以**結構化分支模型**換取**發布可控性與並行開發效率**。掌握其核心分支職責、合併規則與工具命令，配合 CI/CD 與 Code Review，能讓團隊在「功能開發、版本發布、線上熱修」三條主線上有序推進，實現「開發無干擾、發布無驚險、回滾有依據」的工程化目標。