如何从 git 存储库克隆、获取或稀疏检出单个目录或目录列表？

Question

如何从 git 存储库克隆、获取或稀疏检出单个文件或目录或文件或目录列表，以避免下载整个历史记录或至少保持历史记录下载最少？

为了登陆这里的人的利益，这些是对其他类似问题的参考：

• 如何仅克隆 Git 存储库的子目录？
• 如何从 git 存储库中稀疏地检出一个文件？
• 是否可以在不先检出整个存储库的情况下进行稀疏检出？

很久以前就有人问过这些类似的问题，从那以后 git 不断发展，最终导致了大量不同的答案，有些更好，有些更糟，具体取决于所考虑的 git 版本。 麻烦的是，上述问题中没有一个答案能满足所有这些问题的所有要求，这意味着您必须阅读所有答案并在头脑中编译自己的答案，最终才能满足所有要求。

这里的这个问题扩展了前面提到的问题，提出了比所有其他问题加起来更灵活和严格的要求。 所以，再一次：

如何从 git 存储库克隆、获取或稀疏检出单个文件或目录或文件或目录列表，以避免下载整个历史记录或至少保持历史记录下载最少？

Answer 1

下面的这个bash函数可以解决问题。

function git_sparse_checkout {
    # git repository, e.g.: http://github.com/frgomes/bash-scripts
    local url=$1
    # directory where the repository will be downloaded, e.g.: ./build/sources
    local dir=$2
    # repository name, in general taken from the url, e.g.: bash-scripts
    local prj=$3
    # tag, e.g.: master
    local tag=$4
    [[ ( -z "$url" ) || ( -z "$dir" ) || ( -z "$prj" ) || ( -z "$tag" ) ]] && \
        echo "ERROR: git_sparse_checkout: invalid arguments" && \
        return 1
    shift; shift; shift; shift

    # Note: any remaining arguments after these above are considered as a
    # list of files or directories to be downloaded.
    
    mkdir -p ${dir}
    if [ ! -d ${dir}/${prj} ] ;then
        mkdir -p ${dir}/${prj}
        pushd ${dir}/${prj}
        git init
        git config core.sparseCheckout true
        local path="" # local scope
        for path in $* ;do
            echo "${path}" >> .git/info/sparse-checkout
        done
        git remote add origin ${url}
        git fetch --depth=1 origin ${tag}
        git checkout ${tag}
        popd
    fi
}

这是如何使用它的示例：

function example_download_scripts {
  url=http://github.com/frgomes/bash-scripts
  dir=$(pwd)/sources
  prj=bash-scripts
  tag=master
  git_sparse_checkout $url $dir $prj $tag "user-install/*" sysadmin-install/install-emacs.sh
}

在上面的例子中，注意目录后面必须跟/*并且必须在单引号或双引号之间。

更新：可以在以下位置找到改进版本： https : //github.com/frgomes/bash-scripts/blob/master/bin/git_sparse_checkout

Answer 2

如果您只想要没有历史记录的文件，您可以使用 svn：

SUBDIR=foo
svn export https://github.com/repository.git/trunk/$SUBDIR