Git Sparse Checkout使用指南

Git Sparse Checkout使用指南

Git的clone，默认是直接拉取整个远程仓库，如果项目比较大，在进行clone时，会导致拉取到大量和自己无关的内容到本地，占用很多硬盘空间。

Git在1.7版本后，已经支持只Checkout部分内容，这个功能叫做 Sparse Checkout（稀疏检出），使用该功能可以节省本地硬盘空间。
使用步骤

准备工作：如果本地还没有版本库，则先执行下述命令

git init <project>
cd <project>
git remote add origin ssh://<user>@<repository's url>

1.开启sparse checkout功能

开启：

git config core.sparsecheckout true

或者
git sparse-checkout init
2.写入要获取的文件

1）写入文件：
echo “x x x” >> .git/info/sparse-checkout

例如：

echo "Test" >> .git/info/sparse-checkout 

表示只拉取Test文件夹，
或者使用命令
git sparse-checkout set Test

附：sparse checkout文件设置

子目录的匹配

在 sparse-checkout 文件中，如果目录名称前带斜杠，如/docs/，将只匹配项目根目录下的docs目录，如果目录名称前不带斜杠，如docs/，其他目录下如果也有这个名称的目录，如test/docs/也能被匹配。
而如果写了多级目录，如docs/01/，则不管前面是否带有斜杠，都只匹配项目根目录下的目录，如test/docs/01/不能被匹配。

通配符 “*“ (星号)

在 sparse-checkout 文件中，支持通配符 “*“，如可以写成以下格式：
docs/
index.
*.gif

排除项 “!” (感叹号)

在 sparse-checkout 文件中，也支持排除项 “!”，如只想排除排除项目下的 “docs” 目录，可以按如下格式写：
/*
!/docs/

注意：如果要关闭sparsecheckout功能，全取整个项目库，可以写一个”*“号，但如果有排除项，必须写成”/星号“，同时排除项要写在通配符后面。

2）执行git pull/fetch命令
（每次更改sparse-checkout增加或删除目录时，都需要执行一次该命令）。
3.关闭sparse checkout功能

使用命令：
git sparse-checkout disable