（一）GitLab 中的分支和標簽的定義及操作

1. 分支（Branch）

定義：
分支是代碼倉庫中的獨立開發路徑，允許你在不影響主線（通常是 main 或 master 分支）的情況下，進行實驗、開發新功能或修復錯誤。

相關命令：

• 創建分支：

  git branch <branch-name>
  

  例如，git branch feature-login 會基于當前所在分支的最新提交創建一個名為 feature-login 的新分支。

• 從指定起點創建分支：

  git branch <branch-name> <start-point>
  

  例如，git branch bugfix-123 34a5678 以哈希值為 34a5678 的提交為起點創建 bugfix-123 分支。

• 切換分支：

  git checkout <branch-name>
  

  或者使用 git switch <branch-name>（Git 1.22.0 及以上版本）。

• 創建并切換到新分支：

  git checkout -b <branch-name>
  

  或者使用 git switch -c <branch-name>（Git 1.22.0 及以上版本）。

• 查看分支：

  git branch
  

  查看本地所有分支，當前所在分支前會有 * 標記。

• 查看本地和遠程所有分支：

  git branch -a
  

• 刪除本地分支：

  git branch -d <branch-name>
  

  如果分支還沒有合并到當前分支，Git 會拒絕刪除。使用 -D 強制刪除。

• 刪除遠程分支：

  git push origin --delete <branch-name>
  

2. 標簽（Tag）

定義：
標簽是用于標記代碼倉庫中某個特定提交的輕量級引用，通常用于標記項目中的重要版本，如發布版本（v1.0.0、v2.0.0 等）。

相關命令：

• 創建輕量標簽：

  git tag <tag-name>
  

  例如，git tag v1.0.0 創建一個輕量標簽。

• 創建含注釋標簽：

  git tag -a <tag-name> -m "注釋信息"
  

  例如，git tag -a v1.0.1 -m "Release version 1.0.1" 創建一個含注釋的標簽。

• 查看標簽：

  git tag
  

  列出所有本地標簽。

• 查看標簽詳情：

  git show <tag-name>
  

  查看標簽的詳細信息，包括關聯的提交信息、標簽的注釋（如果是含注釋標簽）。

• 推送標簽到遠程倉庫：

  git push origin <tag-name>
  

  或者推送所有標簽：

  git push origin --tags
  

• 刪除本地標簽：

  git tag -d <tag-name>
  

• 刪除遠程標簽：

  git push origin :refs/tags/<tag-name>
  

小結

分支和標簽在版本控制中扮演著不同的角色。分支用于并行開發，允許開發者在獨立的環境中進行實驗和開發，而標簽則用于標記特定的代碼版本，通常用于版本發布和記錄項目里程碑。

場景：開發一款電商網站

假設我們正在開發一款電商網站，項目使用 Git 進行版本控制，并托管在 GitLab 上。

1. 分支（Branch）

定義：
分支是代碼倉庫中的一個獨立開發路徑，允許你在不影響主線代碼的情況下進行開發。

生產實例：

• 主線分支（main 或 master）：

  • 這是項目的主分支，包含了當前生產環境的穩定代碼。所有經過測試和驗證的功能都會合并到這里。
  • 例如，main 分支的代碼部署在生產服務器上，用戶可以訪問網站。

• 開發分支（develop）：

  • 這是開發團隊的主要工作分支，用于集成新功能和修復。
  • 開發人員在 develop 分支上進行日常開發，然后定期將代碼合并到 main 分支。

• 功能分支（feature/*）：

  • 當開發新功能時，開發人員會從 develop 分支創建一個功能分支，例如 feature/user-login。
  • 在這個分支上，開發人員可以獨立開發用戶登錄功能，而不影響其他開發工作。
  • 完成后，通過合并請求（Merge Request）將代碼合并回 develop 分支。

• 修復分支（fix/*）：

  • 如果在生產環境中發現了一個緊急問題，開發人員會從 main 分支創建一個修復分支，例如 fix/bug-123。
  • 在這個分支上修復問題后，通過合并請求將代碼合并回 main 分支，并發布新版本。

小結：
分支是動態的，用于開發和集成代碼。開發人員可以在分支上進行實驗、開發新功能或修復問題，而不會影響主線代碼的穩定性。

2. 標簽（Tag）

定義：
標簽是代碼倉庫中某個特定提交的標記，通常用于標記項目的重要版本，如發布版本。

生產實例：

• 發布版本：

  • 當開發團隊完成了一個新版本的開發，并且代碼已經通過測試，準備發布時，他們會創建一個標簽。
  • 例如，當 develop 分支的代碼合并到 main 分支后，開發團隊會創建一個標簽 v1.0.0：

    git tag -a v1.0.0 -m "Release version 1.0.0"
    git push origin v1.0.0
    

  • 這個標簽 v1.0.0 標記了代碼的某個特定狀態，表示這是網站的第一個正式版本。

• 回溯和修復：

  • 如果在生產環境中發現了一個問題，開發人員可以查看標簽 v1.0.0，找到對應的代碼狀態。
  • 他們可以在這個基礎上創建一個修復分支，例如 fix/bug-123，修復問題后再次發布新版本，例如 v1.0.1：

    git tag -a v1.0.1 -m "Release version 1.0.1 with bug fix"
    git push origin v1.0.1
    

小結：
標簽是靜態的，用于標記代碼的某個特定狀態。它們通常用于發布版本，方便開發人員在需要時回溯到特定的代碼狀態。

（二）分支和標簽的差別

• 分支：

  • 用途：用于開發和集成代碼。
  • 特性：動態的，可以隨時修改和更新。
  • 操作：創建、切換、合并、刪除分支。
  • 示例：feature/user-login、fix/bug-123。

• 標簽：

  • 用途：用于標記代碼的特定狀態，通常是發布版本。
  • 特性：靜態的，一旦創建，不能修改。
  • 操作：創建、查看、刪除標簽。
  • 示例：v1.0.0、v1.0.1。

生產實例總結

• 分支：

  • 開發人員在分支上進行功能開發和修復。
  • 通過合并請求將代碼集成到主線分支。
  • 例如：feature/user-login、fix/bug-123。

• 標簽：

  • 在發布新版本時創建標簽。
  • 用于標記代碼的特定狀態，方便回溯和修復。
  • 例如：v1.0.0、v1.0.1。

通過這個生產實例，你可以清楚地看到分支和標簽在實際開發中的不同用途和操作方式。

（三）分支和標簽的切換

1. 標簽的切換命令

在 Git 中，標簽（Tag）本身并不是一個可以切換到的“工作區”，因為標簽只是一個指向特定提交的引用，而不是一個獨立的開發路徑（像分支那樣）。因此，你不能直接“切換”到一個標簽，但可以通過以下方式查看標簽對應的代碼狀態：

git checkout <tag-name>

例如：

git checkout v1.0.0

這會將你的工作區切換到標簽 v1.0.0 所指向的提交。此時，你的工作區會處于“分離頭指針”（Detached HEAD）狀態，這意味著你當前不在任何分支上。

2. 標簽與分支的原理區別

• 分支：

  • 分支是一個動態的開發路徑，可以隨時修改和更新。
  • 當你切換到一個分支（如 feature/user-login）時，你在該分支上所做的任何更改都會被記錄在這個分支的歷史中。
  • 分支有自己的提交歷史，可以獨立于其他分支進行開發。

• 標簽：

  • 標簽是一個靜態的引用，指向某個特定的提交。
  • 標簽不會像分支那樣有獨立的提交歷史。
  • 標簽通常用于標記重要的版本（如發布版本），而不是用于開發。

3. 標簽對應的分支

標簽本身并不直接關聯到某個分支，但它通常是從某個分支上的某個提交創建的。例如，你可能在一個分支（如 main 或 develop）上創建了一個標簽。

示例：創建標簽并查看其對應的分支

假設你有一個項目，當前在 main 分支上，你剛剛發布了一個新版本 v1.0.0。

創建標簽

git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0

查看標簽對應的提交

git show v1.0.0

這會顯示標簽 v1.0.0 所指向的提交的詳細信息，包括提交的哈希值、提交信息、作者等。

查看標簽對應的分支

雖然標簽本身不直接關聯到某個分支，但你可以通過查看提交的哈希值來確定它來自哪個分支。例如：

git branch --contains <commit-hash>

假設標簽 v1.0.0 指向的提交哈希值是 abc123，你可以運行：

git branch --contains abc123

這會列出所有包含該提交的分支。通常，你會看到 main 分支（或你創建標簽時所在的分支）。

涉及的命令總結

創建標簽

git tag -a <tag-name> -m "注釋信息"
git push origin <tag-name>

查看標簽

git tag
git show <tag-name>

查看標簽對應的分支

git branch --contains <commit-hash>

切換到標簽對應的提交

git checkout <tag-name>

注意事項

• 分離頭指針狀態：當你切換到一個標簽時，Git 會提示你處于“分離頭指針”狀態。這意味著你當前不在任何分支上，任何新的提交都不會被記錄在某個分支的歷史中。
• 回到分支：完成查看后，建議切換回一個分支（如 main 或 develop），以繼續開發：

  git checkout main
  

通過這些命令和操作，你可以清楚地管理標簽和分支，確保項目的版本控制清晰且高效。