Git的稀疏检出功能
稀疏检出定义：
所谓稀疏检出就是：Git本地库检出时不检出全部，只将指定的文件从Git本地库检出到Git工作区，而其他未指定的文件则不予检查（即使这些文件存在于工作区，其修改也会被忽略）。
稀疏检出设置：
想要实现稀疏检出的功能，必须设置core.sparseCheckout配置变量，并存在文件.git/info/spare-checkout。即首先要设置Git配置变量core.sparseCheckout为true，然后编辑.git/info/spare-checkout文件，将要检出的目录或文件的路径写入其中。其中文件.git/info/sparse-checkout的格式和.gitignore文件格式一样，路径可以使用通配符。
稀疏检出如何实现？
实际上Git在index(即Git暂存区)中为每个文件提供一个名为skip-worktree的标志位，默认这个标志位处于关闭状态。如果开启该标志位，则无论Git工作区对应的文件存在是否，或者是否被修改，Git都认为Git工作区该文件的版本是最新的、无变化的。Git通过配置文件.git/info/spare-checkout定义一个要检查的目录和或文件列表，当前Git的基于合并（git merge、git checkout）等命令能够根据该配置文件更新的index中文件的skip-worktree表示位，实现Git本地库文件的稀疏检出。
体验Git的稀疏检出功能（命令行操作）
1.克隆创建Git本地库
首先在worksparce1工作区中通过克隆的方法创建一个Git本地库sparse-checkout
命令：git clone
| root@fengyangvm:~/workspace1# git clone git@gitlab.szreach.com:fengyang/sparse-checkout.git Cloning into 'sparse-checkout'... remote: Counting objects: 17, done. remote: Compressing objects: 100% (7/7), done. remote: Total 17 (delta 2), reused 0 (delta 0) Receiving objects: 100% (17/17), done. Resolving deltas: 100% (2/2), done. |
2.查看sparse-checkout Git本地库包含的内容
创建好sparse-checkoutGit本地库后查看包含如下内容：
命令：ls -F
| doc1/ doc2/ doc3/ README |
命令：git ls-files -s -v
| H 100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 0 README H 100644 9d607966b721abde8931ddd052181fae905db503 0 doc1/readme.txt H 100644 8fdd954df9831dfd29ceec0d74829b02f3f5d8c3 0 doc2/readme.txt H 100644 dc7b54ad014355b948b93c4c6c5891da053d5fdd 0 doc3/readme.txt |
即sparse-checkout版本库中包含三个目录doc1、doc2、doc3和一个文件README。命令git ls-files的-s参数用来显示对象的SHA1哈希值及所处暂存区的编号。而-v参数则显示工作区文件的状态，每一行命令输出的第一个字符即是文件状态：字母H表示文件已被暂存，如果是字母S则表示该文件skip-worktree的标志位已开启。
3.修改Git版本库的配置变量core.sparseCheckout,将其设置为true
命令：git config core.sparsecheckout true
设置完成后，用命令查看：git config -l
| user.name=冯阳 user.email=fengyang@rd.szreach.com core.repositoryformatversion=0 core.filemode=true core.bare=false core.logallrefupdates=true core.sparsecheckout=true remote.origin.fetch=+refs/heads/*:refs/remotes/origin/* remote.origin.url=git@gitlab.szreach.com:fengyang/sparse-checkout.git branch.master.remote=origin branch.master.merge=refs/heads/master |
4.设置.git/info/sparse-checkout的内容
设置.git/info/sparse-checkout的内容,如下：
命令：vim .git/info/sparse-checkout
doc1
doc3
查看：cat .git/info/spares-checkout
| doc1 doc3 |
5.执行git checkout命令
当执行git checkout命令后，查看会发现doc2目录不见了。
命令：git checkout
命令：ls -F
| doc1/ doc3/ |
6.用git ls-files -v命令去查看
这是如果用git ls-files -v命令去查看，会发现工作区的README和doc2目录下的文件被设置了skip-worktree标志。
命令：git ls-files -v
| S README H doc1/readme.txt S doc2/readme.txt H doc3/readme.txt |
7.文件.git/info/sparse-checkout也支持用星号（*）和感叹号（！）操作
修改.git/info/sparse-checkout的内容，使之包含一个星号，即可在工作区检出所有内容
命令：vim .git/info/sparse-checkout
*
查看：cat .git/info/spares-checkout
| * |
执行git checkout,会发现所有的目录又都回来了。
命令：git checkout
命令：ls -F
| doc1/ doc2/ doc3/ README |
‚修改.git/info/sparse-checkout的内容，使之不检查目录doc2下的文件，而检查其他文件，可以使用下面语法（注意顺序不能写反）
命令：vim .git/info/sparse-checkout
*
！doc2/*
执行git checkout查看效果
命令：git checkout
命令：ls -F
| doc1/ doc3/ README |
注意：如果在这使用命令git checkout -- <file>... ，既不是切换分支而是用分支中的文件替换暂存区和工作区，则忽略skip-worktree标志。例如在上面的设置中，虽然doc2被设置为不检出，但是执行git checkout .命令后，所有的目录还是都被检出。
命令：git checkout .
命令：git ls-files -v
| H README H doc1/readme.txt S doc2/readme.txt H doc3/readme.txt |
8.修改不检出目录下的文件或着在不检出目录下添加新文件，Git会视而不见
doc2目录是设置为不检出的，现在在修改doc2目录下的文件，用命令git status查看，git会视而不见，查看不到任何状态。
命令：vim doc/readme.txt
hello
命令：git status
| root@fengyangvm:~/workspace1/sparse-checkout# git status # On branch master nothing to commit (working directory clean) |
9.可以从Git远程数据库拉取其他用户推送的doc2历史记录
在workspace2工作区克隆sparse-checkout版本库，再修改doc2目录下的文件，或者在doc2目录下添加新文件，并且提交到Git本地库以及推送到Git远程库。
workspace1工作区中sparse-checkout版本库拉取最新的修改历史记录
命令：git pull origin
| root@fengyangvm:~/workspace1/sparse-checkout# git pull origin remote: Counting objects: 7, done. remote: Compressing objects: 100% (2/2), done. remote: Total 4 (delta 1), reused 0 (delta 0) Unpacking objects: 100% (4/4), done. From gitlab.szreach.com:fengyang/sparse-checkout 7ee66a3..141ec35 master -> origin/master Updating 7ee66a3..141ec35 Fast-forward doc2/readme.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) |
10.更改doc2目录下文件的skip-worktree标志为检出
更改doc2目录下文件的skip-worktree标志为检出的，通过取消core.sparsecheckout配置变量的设置而关闭稀疏检查不行的。这种情况通过git updat-index --no-skip-worktree -- <file>...来更改index中对应文件的skip-worktree标志，或者需要重新启用稀疏检出更改相应文件的检出状态，或者重新克隆份。
命令：git update-index --no-skip-worktree doc2/*
命令：git ls-files -v
| root@fengyangvm:~/workspace1/sparse-checkout# git update-index --no-skip-worktree doc2/* root@fengyangvm:~/workspace1/sparse-checkout# git ls-files -v H README H doc1/readme.txt H doc2/readme.txt H doc3/readme.txt |