Git多分支使用手冊

目錄

• 多分支只拉取一個
• 多分支拉取指定幾個
• 常見問題與解決方法

多分支只拉取一個

如果只需要克隆遠程倉庫中的單個分支，可以使用 --single-branch 和 --branch 選項：

git clone --single-branch --branch <目標分支名稱> <遠程倉庫地址>

示例：

git clone --single-branch --branch feature/beijing-ybss/V1.0/20240717 http://git.sf-express.com/scm/gis-jw/gis-jw-core-databoard.git

多分支拉取指定幾個

若需要克隆多個特定分支（避免克隆全部分支），可分兩步操作：

步驟 1：克隆第一個分支

git clone --single-branch --branch <分支1名稱> <遠程倉庫地址>
cd <項目目錄>

示例：

git clone --single-branch --branch feature/beijing-ybss/V2.0/20250325 http://git.sf-express.com/scm/gis-jw/gis-jw-core-databoard.git
cd gis-jw-core-databoard

步驟 2：獲取其他分支

# 設置遠程倉庫關注的分支
git remote set-branches origin <分支2名稱># 拉取目標分支
git fetch origin <分支2名稱># 創建并切換到本地分支
git checkout -b <本地分支名> origin/<遠程分支名>

示例：

git remote set-branches origin feature/beijing-ybss/V1.0/20240717
git fetch origin feature/beijing-ybss/V1.0/20240717
git checkout -b feature/beijing-ybss/V1.0/20240717 origin/feature/beijing-ybss/V1.0/20240717

常見問題與解決方法

1. 錯誤：origin/分支名 is not a commit

原因：未正確獲取遠程分支信息。
解決方法：

git fetch -p origin  # 強制更新遠程分支并清理無效引用

2. 分支名稱沖突

現象：本地已存在同名分支。
解決方法：

git branch -D <沖突分支名>  # 刪除本地沖突分支

3. --single-branch 限制

說明：使用 --single-branch 克隆后，默認無法直接切換到其他分支。
解決方案：

git remote set-branches origin <目標分支名>  # 告訴Git關注該分支
git fetch origin <目標分支名>
git checkout -b <本地分支名> origin/<目標分支名>

總結

• 單分支克隆：使用 --single-branch --branch。
• 多分支克隆：先克隆主分支，再通過 git remote set-branches 和 git fetch 獲取其他分支。
• 分支切換：使用 git checkout <分支名>。