Git 分支策略與版本命名規範：Maven 坐標、Release/Snapshot、分支模型全解析

Git 分支策略與版本命名規範：Maven 坐標、Release/Snapshot、分支模型全解析

規範的版本號與分支模型是團隊協作、持續交付的基石。本文梳理 Maven 版本命名規則、Git 分支策略與發布流程，助力建立清晰可控的版本管理體系。

Maven 版本坐標

<dependency>
  <groupId>com.koala</groupId>
  <artifactId>soa</artifactId>
  <version>版本號</version>
</dependency>

穩定版 發布版命名規則

格式：主版本.次版本.修訂版（如 1.2.3）

規則： 新次版本發布後，舊次版本停止維護。如 1.2.0 發布，1.1.x 最新 1.1.3 凍結，後續修復併入 1.2.1。

開發版 快照版命名規則

格式：主版本.次版本.0-SNAPSHOT（如 1.2.0-SNAPSHOT）

特性： 依賴 SNAPSHOT 版本意味著構建時自動拉取該次版本最新構建產物，適合開發/測試環境，嚴禁發布到生產倉庫。

Git 分支模型

1. 主分支： 永遠代表最新穩定發布版。每次發布打 Tag（如 v1.2.0）。
2. 功能/發布分支： 每個次版本建立分支（如 branch-1.2），分支上為該版本最新開發狀態。
3. 分支生命週期： 次版本發布後，對應分支凍結不再維護，新功能在新分支開發。

工作流程示例

# 開發 1.2 版本新功能
git checkout -b branch-1.2 master
# ... 開發、提交 ...
# 發布 1.2.0
git checkout master
git merge branch-1.2
git tag v1.2.0
mvn deploy -DskipTests  # 發布 Release 版

# 修復 1.2 版本 Bug
git checkout -b hotfix-1.2.1 v1.2.0
# ... 修復 ...
git checkout master
git merge hotfix-1.2.1
git tag v1.2.1

# 開發 1.3 版本
git checkout -b branch-1.3 master

最佳實踐建議

• 採用 GitFlow 或 GitHub Flow 規範團隊操作。
• CI/CD 管道自動化：Merge 到 master 自動構建 Release、打 Tag、發布制品庫。
• 語義化版本（SemVer）擴展：MAJOR.MINOR.PATCH[-PRE.RELEASE][+BUILD]。
• 分支命名規範：feature/xxx、bugfix/xxx、hotfix/xxx、release/x.y。

建立統一的版本與分支規範，能大幅減少「版本衝突、發布錯誤、回滾困難」等協作痛點。