Git標籤（Tag）是Git倉庫中用於標記特定提交點的一種方式，就像給項目的重要時刻打個“快照”，這樣無論後續代碼怎麼修改，你都能隨時回到這個點查看當時的代碼狀態。標籤通常用於標記版本號（如v1.0、v2.1.3），方便團隊協作和版本回溯。

一、什麼是Git標籤？爲什麼要用標籤？¶

標籤的定義¶

Git標籤本質上是對某個特定提交的“永久性標記”。它就像一個錨點，讓你能快速定位到項目的關鍵階段（比如第一次發佈、重要功能完成）。

與分支的區別¶

• 分支（Branch）：是動態的“線”，用於持續開發（如main分支、dev分支），會隨着提交不斷向前移動。
• 標籤（Tag）：是靜態的“點”，一旦創建就不會再改變，通常用於標記已完成的穩定版本（如v1.0、v2.0）。

爲什麼需要標籤？¶

• 版本管理：清晰標記項目的發佈版本（如v1.0、v1.1），方便用戶或團隊知道當前使用的是哪個版本。
• 快速回溯：如果後續發現問題，可以直接切換到對應標籤查看當時的代碼狀態。
• 協作共享：在團隊協作中，標籤能讓所有人快速對齊版本，避免“我這邊是v1.0，你那邊怎麼是v1.1”的混亂。

二、創建標籤：選擇輕量標籤還是帶註釋標籤？¶

Git標籤分爲兩種類型，根據使用場景選擇：

1. 輕量標籤（Lightweight Tag）¶

• 特點：簡單快捷，僅保存提交哈希值，不附帶額外信息（無作者、日期、註釋）。
• 適用場景：臨時標記或內部草稿版本。
• 創建命令：

  git tag v1.1  # 創建輕量標籤（直接指定版本號）

2. 帶註釋標籤（Annotated Tag）¶

• 特點：更正式，包含標籤名稱、創建者、日期、自定義註釋，可驗證標籤的來源和內容。
• 適用場景：正式發佈版本（如v1.0、v2.0.3）。
• 創建命令：

  git tag -a v1.0 -m "Initial stable version"  # -a表示帶註釋，-m指定註釋內容

（如果不寫註釋，Git會自動打開編輯器讓你輸入）

三、查看標籤：確認創建是否成功¶

創建標籤後，用以下命令查看所有標籤：

git tag  # 列出所有標籤（不帶註釋）
git tag -n  # 列出所有標籤並顯示註釋
git show v1.0  # 查看特定標籤（如v1.0）的詳細信息（包含提交內容和註釋）

四、管理標籤：刪除與推送¶

1. 刪除標籤¶

• 本地刪除：僅刪除本地標籤，不影響遠程倉庫：

  git tag -d v1.0  # 刪除名爲v1.0的標籤

• 遠程刪除：如果標籤已推送到遠程倉庫，需先刪除遠程標籤：

  git push origin --delete v1.0  # 刪除遠程倉庫的v1.0標籤

（如果本地已刪除，可直接執行上述命令；若本地未刪除，需先執行git tag -d v1.0再遠程刪除）

2. 推送標籤到遠程倉庫¶

• 推送單個標籤：將本地標籤推送到遠程（如GitHub/GitLab）：

  git push origin v1.0  # 推送v1.0標籤到origin倉庫

• 推送所有標籤：一次性推送所有本地標籤到遠程：

  git push origin --tags  # 推送所有未推送的標籤

五、Git標籤最佳實踐¶

1. 版本號規範：語義化版本（Semantic Versioning）¶

遵循MAJOR.MINOR.PATCH格式（主版本.次版本.修訂號），明確版本含義：
- MAJOR：主版本號（不兼容的API變化，如v2.0）
- MINOR：次版本號（向後兼容的功能新增，如v1.1）
- PATCH：修訂號（向後兼容的bug修復，如v1.0.1）
- 示例：v1.2.3表示主版本1，次版本2，修訂號3。

2. 標籤命名規則¶

• 統一前綴：用v開頭（如v1.0），避免與分支名（如main、dev）混淆。
• 避免歧義：標籤名稱簡潔明確，不包含複雜字符（如v1.0-beta僅在特殊測試版本使用）。

3. 常見使用場景¶

• 發佈版本：項目完成一個穩定版本後（如v1.0），立即打標籤。
• 重要里程碑：如項目第一個版本、首個功能完成時（如v0.1）。
• 熱修復標記：緊急修復後標記補丁版本（如v1.0.1）。

4. 注意事項¶

• 標籤不可修改：一旦創建並推送標籤，內容無法直接修改。若需修正，需刪除舊標籤後重新創建。
• 不要頻繁打標籤：標籤是“穩定版本的快照”，不要爲日常開發的臨時提交打標籤（如v1.0.0.1這種頻繁變更的標籤無意義）。
• 團隊協作必推標籤：確保所有團隊成員通過git push origin --tags同步標籤，避免版本信息不一致。

六、總結¶

Git標籤是版本管理的“導航燈”，掌握以下關鍵點即可：
1. 創建標籤：用-a（帶註釋）標記正式版本，-d（輕量）標記臨時版本。
2. 管理標籤：本地刪除用git tag -d，遠程刪除用git push origin --delete，推送用git push origin --tags。
3. 最佳實踐：遵循語義化版本規範，用v前綴命名，僅在穩定版本時打標籤。

通過合理使用標籤，你可以讓項目版本清晰可控，協作更順暢，後續維護也更輕鬆。