[教程]使用 Git 克隆指定分支_git clone 指定branch

Git 是我们开发过程中经常使用到的版本管理工具,在平常情况下我们从远程克隆的时候会将整个库克隆下来，这会包括整个版本库的历史提交记录和远程库里的所有分支。但在一些情况下，比如我们并不需要查看历史提交记录而只是希望能够获取到最新的代码；或者我们只希望克隆某个指定分支时，而不是克隆全部的远程分支，此时我们就可以用到一些选项来减少我们的仓库的体积从而提高生产效率。

指定远程分支克隆的好处;

1. 减少仓库下载体积,提高代码仓库下载速度
   a. 在没有需要查看历史提交的情况下,使用浅克隆模式只克隆最新一次的提交内容:
   git clone --depth 1 -b master git@www.gitee.com/ghimi/hello.git
   b. 在远程仓库分支比较多的情况下,只克隆远程仓库的指定分支和其上的全部提交记录:
   git clone --single-branch -b master git@www.gitee.com/ghimi/hello.git

通过-b branch_name 选项Git 克隆指定分支

当我们没有通过 -b 选项指定分支时，Git 会默认会在本地创建一个 master/main分支并关联到远程的主干分支上，但如果我们希望创建的本地分支关联的不是主干分支时，我们就可以通过-b 选项来指定我们追踪的远程分支名称如：

# 指定克隆远程分支 `/develop/branch_1## 标题`
> git clone -b /develop/branch_1 git@www.gitee.com/ghimi/hello.git
1
2

-b选项搭配 --single-branch 选项只克隆指定分支

通过这种方式克隆远程仓库除了指定的远程分支不是主干分支以外，还是会将远程的所有分支都拉取下来，并不能够起到减小克隆仓库体积的功能。

# 指定克隆远程分支 `/develop/branch_1`
> git clone -b /develop/branch_1 git@www.gitee.com/ghimi/hello.git
> cd hello
# 进入仓库，通过 git branch -r 查看可以看到还是拉取到了全部远程分支
> git branch -r
origin/20200113-function-concurrency-test
origin/20210112_8457548_basic2
origin/HEAD -> origin/master
origin/acl_retrofit
origin/add_api_for_get_organizations
1
2
3
4
5
6
7
8
9
10

如果想要只克隆指定分支还需要搭配 --single-branch 选项，这样我们就只会拉取到我们指定的分支，而不会拉取到其他远程分支了

# 指定克隆远程分支 `/develop/branch_1`
> git clone -b /develop/branch_1 --single-branch git@www.gitee.com/ghimi/hello
> cd hello
# 进入仓库，通过 git branch -r 当前就只剩下一个分支了
> git branch -r
/origin/develop/branch_1
1
2
3
4
5
6

通过 --depth <depth> 选项指定历史记录的深度

在一些情况下导致仓库体积过大的原因并不是分支太多，而是单个分支下的提交记录过多，我们在一些情况下只想查看分支的最新提交的代码，此时我们可以--depth 1 实现浅克隆，此时我们拉取的代码就是最新一次提交后的代码快照。

# 指定克隆远程分支 `/develop/branch_1`
> git clone -b /develop/branch_1 --depth 1 git@www.gitee.com/ghimi/hello
> cd hello
# 进入仓库，通过 git branch -r 当前只有一个分支了
> git branch -r
/origin/develop/branch_1
# 通过 git log 查看历史提交记录，发现只剩下最后一次的提交记录，而无法看到历史的提交记录
> git log
commit 75bdec69e39ea85fcdc750ef289ece7e76d2b79c (grafted, HEAD -> develop/branch_1, origin/develop/branch_1)
Author: ghimi
Date:   Fri Mar 3 15:01:36 2023 +0800
Merge commit 'fc3fe2a0002fc394696ec131797038707f5f4864' into /develop/branch_2
1
2
3
4
5
6
7
8
9
10
11
12

在指定了 --depth 选项后，就无需再指定 --single-branch 选项了。因为浅克隆模式默认隐含了 --single-branch 选项，如果想要在 --depth 选项的基础上还拉取其他分支的代码，可以通过添加 --no-single-branch 选项，此时会拉取到全部远程分支的对应的最近一次的提交记录。

# 指定克隆远程分支 `/develop/branch_1`
> git clone -b /develop/branch_1 --depth 1 --no-single-branch git@www.gitee.com/ghimi/hello.git
> cd hello
# 进入仓库，通过 git branch -r 可以看到拉取到了全部远程分支
> git branch -r
origin/develop/branch_1
origin/20200113-function-concurrency-test
origin/20210112_8457548_basic2
origin/HEAD -> origin/master
origin/acl_retrofit
origin/add_api_for_get_organizations
# 通过 git log 查看历史提交记录,发现只剩下最后一次的提交记录，而无法看到历史的提交记录
> git log
commit 75bdec69e39ea85fcdc750ef289ece7e76d2b79c (grafted, HEAD -> develop/branch_1, origin/develop/branch_1)
Author: ghimi
Date:   Fri Mar 3 15:01:36 2023 +0800
Merge commit 'fc3fe2a0002fc394696ec131797038707f5f4864' into /develop/branch_2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

通过 git fetch --unshallow 恢复全部的历史提交记录

我们在使用 --depth 1 查看到了当前代码后，如果想要追溯代码的历史提交记录时，可以用 git fetch --unshallow 命令重新拉取指定远程分支的全部历史记录。

# 指定克隆远程分支 `/develop/branch_1`
> git clone -b /develop/branch_1 --depth 1 git@www.gitee.com/ghimi/hello
> cd hello
# 进入仓库，通过 git branch -r 当前只有一个分支了
> git branch -r 
/origin/develop/branch_1
# 通过 git log 查看历史提交记录，发现只剩下最后一次的提交记录，而无法看到历史的提交记录
> git log
commit 75bdec69e39ea85fcdc750ef289ece7e76d2b79c (grafted, HEAD -> develop/branch_1, origin/develop/branch_1)
Author: ghimi
Date:   Fri Mar 3 15:01:36 2023 +0800
Merge commit 'fc3fe2a0002fc394696ec131797038707f5f4864' into /develop/branch_2
> git fetch --unshallow
remote: Enumerating objects: 79593, done.
remote: Counting objects: 100% (79593/79593), done.
remote: Total 79593 (delta 2162), reused 77796 (delta 2162), pack-reused 0
Receiving objects: 100% (79593/79593), 23.05 MiB | 3.43 MiB/s, done.
Resolving deltas: 100% (2162/2162), done.
From www.gitee.com:ghimi/hello
 * branch                develop/branch_1 -> FETCH_HEAD
# 此时通过 git log 命令查看时就会发现能够看到全部的历史提交记录了
> git log
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

使用 git checkout -t origin/develop/branch_1 在本地创建分支并追踪同名的远程分支

使用 Idea 的同学肯定用过，当在 checkout 远程分支后，会在本地为远程创建一个同名的分支，我们可以在本地分支上完成开发然后推送到相关远程分支上去。其实使用的就是 -t 选项

> git checkout -t origin/develop/branch_1
Switched to a new branch 'develop/branch_1'
Branch 'develop/branch_1' set up to track remote branch 'develop/branch_1' from 'origin'.
1
2
3

克隆不拉取标签 --no-tags

打标一般用于线上版本管理，在本地开发中其实没什么用，可以在 git clone 或者 git fetch 的时候设置选项 --no-tags 指定不拉取标签。

参考资料

Git clone 手册