前言

在現代軟體開發中，Git 分支管理已成為不可或缺的核心技能。無論是個人專案還是大型團隊協作，良好的分支策略能大幅提升開發效率、降低維護成本。本文將從基礎概念出發，深入探討各種分支策略的實戰應用。

一、Git 分支基礎概念

什麼是分支？

分支（Branch）本質上是指向某個提交的指針，它讓開發者能在獨立的環境中進行功能開發、錯誤修復或實驗性嘗試，而不影響主線代碼。

分支的基本操作

查看所有分支

git branch -a

建立新分支

git branch feature-new

切換分支

git checkout feature-new

建立並切換分支

git checkout -b feature-new

刪除分支

git branch -d feature-new

二、主流分支策略模式

1. GitHub Flow（輕量級流程）

適用場景：持續部署環境、小型團隊、Web 應用程式

main (始終可部署) ├── feature/user-authentication ├── feature/payment-integration └── fix/security-patch

核心原則：

• main 分支始終處於可部署狀態
• 新功能建立獨立分支開發
• 透過 Pull Request 進行代碼審查
• 合併後立即部署

工作流程：

1. 從 main 建立功能分支

git checkout -b feature/notifications 或 git branch feature/notifications git checkout feature/notifications

2. 開發並提交更改

git add . git commit -m “feat: add user notification system”

3. 推送到遠端

git push -u origin feature/notifications

-u：第一次推送時設定上游分支，之後只需要 git push 即可

4. 建立 Pull Request 進行審查（個人可省略）

5. 審查通過後合併到 main

git checkout git merge feature/notifications git push origin main

6. 刪除功能分支

git branch -d feature/notifications git push origin –delete new-plan（可選：刪除遠端分支）

2. Git Flow（功能驅動流程）

適用場景：版本發布制軟體、大型團隊、複雜專案

main (生產版本) └── develop (開發主線) ├── feature/user-dashboard ├── release/v1.2.0 └── hotfix/critical-bug

分支類型：

• 功能分支 (feature/)：新功能開發
• 發布分支 (release/)：版本準備
• 熱修復分支 (hotfix/)：生產環境緊急修復

3. Trunk-Based Development（主幹開發）

適用場景：高速迭代團隊、持續整合環境

main ├── short-lived-feature-1 ├── short-lived-feature-2 └── short-lived-feature-3

核心要求：

• 分支生命週期短（通常 < 1 天）
• 頻繁合併到主幹
• 強調功能開關（Feature Flags）

三、分支命名規範

標準化命名約定

<類型>/<描述>-<相關議題>

範例：

feature/user-auth-123 fix/login-validation-456 docs/api-reference-789 hotfix/security-patch-999

常見類型前綴

• feature/：新功能開發
• fix/：錯誤修復
• docs/：文件更新
• style/：樣式調整（不影響邏輯）
• refactor/：代碼重構
• test/：測試相關
• chore/：工具鏈、配置調整

四、實戰演練：Astro 專案分支管理

情境：開發新部落格功能

1. 確保主分支最新

git checkout main git pull origin main

2. 建立功能分支

git checkout -b feature/blog-comments

3. 開發階段（多次提交）

git add . git commit -m “feat: add comment UI components” git add . git commit -m “feat: implement comment submission” git add . git commit -m “test: add comment functionality tests”

4. 推送到

GitHub git push -u origin feature/blog-comments

5. 在 GitHub 建立 Pull Request

6. 團隊成員進行代碼審查

7. 通過後合併到 main

8. 刪除本地分支

git checkout main git branch -d feature/blog-comments

與 Cloudflare Pages 的整合

cloudflare-pages-deploy.yml

name: Cloudflare Pages Deployment

on: push: branches: [ main ] pull_request: branches: [ main ]

jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Build and Deploy run: | npm install npm run build # 自動部署到相應環境

五、團隊協作最佳實踐

分支保護規則

在 GitHub 設定中啟用：

• 要求 Pull Request 審查
• 要求狀態檢查通過
• 要求線性合併歷史
• 限制直接推送至受保護分支

提交訊息規範

<類型>[可選範圍]: <描述>

[可選正文]

[可選註腳]

範例：

feat(blog): add comment moderation system

• Implement comment approval workflow
• Add admin moderation panel
• Include email notifications for new comments

Closes #123, #124

代碼審查清單

• 功能是否符合需求
• 代碼風格一致性
• 測試覆蓋率足夠
• 文件更新齊全
• 無安全疑慮

六、常見問題與解決方案

問題1：合併衝突

解決方案：

更新主分支並重整功能分支

git checkout main git pull origin main git checkout feature/your-branch git rebase main

解決衝突後繼續

git add . git rebase –continue

問題2：分支過多難以管理

解決方案：

• 定期清理已合併分支
• 使用描述性命名
• 建立分支生命週期政策

問題3：部署環境混亂

解決方案：

GitHub Actions 範例

deploy-preview: if: github.event_name == ‘pull_request’ runs-on: ubuntu-latest steps: - name: Deploy to Preview run: echo “Deploying to preview environment”

deploy-production: if: github.ref == ‘refs/heads/main’ runs-on: ubuntu-latest steps: - name: Deploy to Production run: echo “Deploying to production”

七、進階技巧

功能開關（Feature Flags）

// features.js export const features = { NEW_BLOG_COMMENTS: process.env.ENABLE_NEW_COMMENTS === ‘true’, DARK_MODE: process.env.ENABLE_DARK_MODE === ‘true’ };

// 使用方式 if (features.NEW_BLOG_COMMENTS) { enableNewCommentSystem(); }

分支模板工具

#!/bin/bash

create-feature-branch.sh

BRANCH_NAME=“feature/$1” ISSUE_NUMBER=$2

git checkout -b $BRANCH_NAME echo “Created branch: $BRANCH_NAME” echo “Related to issue: #$ISSUE_NUMBER”

結語

良好的分支策略是高效團隊協作的基石。從簡單的 GitHub Flow 到複雜的 Git Flow，選擇適合團隊規模和專案需求的策略至關重要。記住：沒有最好的策略，只有最適合的策略。

透過本文介紹的方法和最佳實踐，您應該能夠建立一套適合自己團隊的高效分支管理工作流，提升開發效率並降低維護成本。

延伸閱讀：

1. Git 官方文件
2. GitHub Flow 指南