如何从GitHub上托管的远程Git存储库中仅下载特定文件夹或目录？

假设示例GitHub存储库位于此处：

git@github.com:foobar/Test.git

其目录结构：

Test/
├── foo/ 
│   ├── a.py
│   └── b.py   
└── bar/
    ├── c.py
    └── d.py

我只想下载foo文件夹，而不克隆整个Test项目。

2016年9月更新：社区创建了一些工具可以为您做到这一点：

• GitZip（学分到基诺 -给予好评他的答案就在这里！）
• DownGit（鸣谢Minhas Kamal- 在这里赞扬他的答案！）

Git不支持此功能，但是Github通过SVN支持。如果您使用subversion签出代码，Github实际上将在后端将仓库从git转换为subversion，然后提供所请求的目录。

使用此功能下载特定文件夹的方法如下。我将以流行的javascript库lodash为例。

1. 导航到要下载的文件夹。让我们/test从下载master分支。

2. 修改要颠覆的URL。替换tree/master为trunk。

   https://github.com/lodash/lodash/tree/master/test ➜

   https://github.com/lodash/lodash/trunk/test

3. 下载资料夹。转到命令行并使用SVN抓取文件夹。

svn checkout https://github.com/lodash/lodash/trunk/test

您可能不会立即看到任何活动，因为Github最多需要30秒来转换较大的存储库，因此请耐心等待。

完整的URL格式说明：

• 如果您有兴趣 master分支，请trunk改用。所以完整的路径是trunk/foldername
• 如果您对foo分支感兴趣，请使用branches/foo改用。完整的路径看起来像branches/foo/foldername
• 提示：您可以根据svn ls需要在下载之前查看可用的标签和分支

就这样！Github还支持更多的Subversion功能，包括对提交和推送更改的支持。

此功能有两个选项：

选项1：GitZip浏览器扩展

Chrome扩展程序，Firefox插件

用法：

1. 在任何GitHub存储库页面中。
2. 只需双击所需项目的空白部分。
3. 点击右下角的下载按钮。
4. 查看进度仪表板，然后等待浏览器触发器下载。
5. 获取ZIP文件。

获取令牌：

1. 单击浏览器上的GitZip Extension图标。
2. 点击“获取令牌”旁边的“普通”或“私人”链接。
3. 在Github身份验证页面上授权GitZip权限。
4. 回到开始的回购页面。
5. 继续使用。

选项2：Github gh页

http://kinolien.github.io/gitzip，使用GitHub API和JSZip，FileSaver.js库。

步骤1：在右上角的字段中输入github网址。
步骤2：按Enter键或单击“下载”以直接下载zip或单击“搜索”以查看子文件夹和文件的列表。
步骤3：点击“下载Zip文件”或“获取文件”按钮以获取文件。

在大多数情况下，它都可以正常工作，但由于Github Trees API的限制，该文件夹包含1,000个以上的文件。（参考Github API＃Contents）

如果您拥有GitHub帐户并在此站点中使用“获取令牌”链接，它还可以支持私有/公共存储库并升级速率限制。

转到DownGit >输入您的URL>下载！

现在，您可以从DownGit 直接为任何GitHub公共目录或文件（特别是大文件）直接下载或创建下载链接！这是一个简单的演示-

您还可以配置下载文件的属性详细用法。

如果有svn，可以使用svn export以下方法：

svn export https://github.com/foobar/Test.git/trunk/foo

注意URL格式：

• 基本网址是 https://github.com/
• /trunk 附加在末尾

在运行之前svn export，最好先使用以下命令验证目录的内容：

svn ls https://github.com/foobar/Test.git/trunk/foo

对于通用git Repo：

如果要下载文件，而不是用历史记录克隆存储库，则可以使用进行git-archive。

git-archive制作git存储库的压缩zip或tar存档。一些使它特别的东西：

1. 您可以选择git存储库中要归档的文件或目录。
2. 它不会存档.git/文件夹或运行它的存储库中的任何未跟踪文件。
3. 您可以存档特定的分支，标记或提交。用git管理的项目经常使用它来生成项目版本的存档（测试版，发行版，2.0等），以供用户下载。

docs/usage从与ssh连接的远程仓库中创建目录存档的示例：

# in terminal
$ git archive --format tar --remote ssh://server.org/path/to/git HEAD docs/usage > /tmp/usage_docs.tar

更多信息，请参见本博客文章和git文档。

关于GitHub Repos的注意事项：

GitHub不允许git-archive访问。☹️

我创建了一个名为GitHubFolderDownloader的开源项目。它使您可以下载存储库的单个文件夹，而无需克隆或下载整个存储库。

其他答案没什么问题，但我只是想与那些第一次在此过程中徘徊的人分享逐步说明。

如何从github存储库（Mac OS X）下载单个文件夹：

〜要打开终端，只需单击聚光灯并键入终端，然后按Enter

1. 在Mac上，您可能已经拥有SVN（要测试打开的终端，然后键入“ svn”或“哪个svn”〜而不带引号）
2. 在Github上：通过单击存储库中的特定文件夹名称，找到git文件夹（而非存储库）的Github路径
3. 从浏览器的地址栏中复制路径
4. 打开终端并输入：svn export
5. 接下来粘贴地址（例如）：https : //github.com/mingsai/Sample-Code/tree/master/HeadsUpUI
6. 替换单词：tree / master
7. 词：树干
8. 键入文件的目标文件夹（在此示例中，我将目标文件夹存储在当前用户的“下载”文件夹中）
9. 这里的空格只是空格键，而不是单词（空格）〜/ Downloads / HeadsUpUI
10. 最终的终端命令显示了下载文件夹的完整命令（将地址与第5步进行比较）svn export https://github.com/mingsai/Sample-Code/trunk/HeadsUpUI〜/ Downloads / HeadsUpUI

顺便说一句-如果您使用Windows或其他平台，则可以在http://subversion.apache.org上找到Subversion（svn）的二进制下载。

〜如果要检出文件夹而不是简单地下载文件夹，请尝试使用svn帮助（tldr：将输出替换为checkout）

更新资料

关于恢复中断的下载/签出的评论。我会先尝试跑步，svn cleanup然后再尝试svn update。请在SO中搜索其他选项。

无论是谁正在处理特定文件夹，他都需要克隆该特定文件夹本身，为此，请使用稀疏签出执行以下步骤。

1. 创建一个目录。

2. 初始化一个Git仓库。（git init）

3. 启用稀疏签出。（git config core.sparsecheckout true）

4. 告诉Git您想要的目录（echo 2015 / brand / May（指您要使用的文件夹）>> .git/info/sparse-checkout）

5. 添加遥控器（git remote add -f origin https://jafartke.com/mkt-imdev/DVM.git）

6. 提取文件（git pull origin master）

你不能; 与Subversion不同，在Subversion中每个子目录都可以单独检出，Git在整个存储库的基础上运行。

对于需要更细粒度访问的项目，可以使用子模块-每个子模块都是一个单独的Git项目，因此可以单独克隆。

可以想象，一个Git前端（例如GitHub的Web界面或gitweb）可以选择提供一个接口以供您提取给定的文件夹，但是据我所知，它们都没有这样做（尽管它们确实允许您下载单个文件） ，因此，如果文件夹中没有太多文件，则可以选择）

编辑 -GitHub实际上提供了通过SVN的访问，这将允许您执行此操作（根据评论）。有关如何执行此操作的最新说明，请参见https://github.com/blog/1438-improved-svn-here-to-stay-old-svn-going-away

如果您确实只想“下载”该文件夹而不是“克隆”该文件夹（以进行开发），那么最简单的方法就是简单地获取该存储库的最新版本（以及其中的一个文件夹/文件）的副本，无需克隆整个repo甚至无需首先安装git，只需通过转到GitHub上所需的存储库/ fork / branch / commit，即可下载zip归档文件（适用于任何repo，fork，branch，commit等）。 （例如，http(s)://github.com/<user>/<repo>/commit/<Sha1>获取特定提交后的文件副本），然后选择Downloads右上角附近的按钮。

这种存档格式不包含任何git-repo魔术，仅包含被跟踪的文件本身（如果被跟踪，则可能包含几个.gitignore文件，但是您可以忽略那些：p）-这意味着如果代码更改并且您想要保持最重要的位置，您将必须手动重新下载它，这也意味着您将无法将其用作git存储库...

不确定在这种情况下这是否就是您要寻找的内容（再次是“下载” /视图与“克隆” /开发），但是它仍然很有用...

2019年总结

有多种处理方法，具体取决于您要手动还是以编程方式进行。

下面总结了四个选项。对于那些希望获得更实际操作说明的人，我整理了一个YouTube视频：从GitHub下载单个文件和文件夹。

此外，对于需要从GitHub下载单个文件（而不是文件夹）的文件，我在StackOverflow上发布了类似的答案。

1. GitHub用户界面

• 存储库主页上有一个下载按钮。当然，这将下载整个存储库，然后您需要解压缩下载文件，然后手动拖出所需的特定文件夹。

2.第三方工具

• 有多种浏览器扩展程序和Web应用程序可以处理此问题，其中DownGit就是其中之一。只需将GitHub URL粘贴到文件夹（例如https://github.com/babel/babel-eslint/tree/master/lib），然后按“下载”按钮。

3.颠覆

• GitHub不支持git-archive（允许我们下载特定文件夹的git功能）。但是GitHub确实支持多种Subversion功能，我们可以为此使用其中之一。Subversion是一个版本控制系统（替代git）。您需要安装Subversion。获取您要下载的文件夹的GitHub URL。不过，您需要修改此URL。您需要链接到存储库，后跟单词“ trunk”，并以嵌套文件夹的路径结尾。换句话说，使用我上面提到的相同的文件夹链接示例，我们将“ tree / master”替换为“ trunk”。最后，打开一个终端，导航到要将内容下载到的目录，键入以下命令（将URL替换为构造的URL）：svn export https://github.com/babel/babel-eslint/trunk/lib，然后按Enter。

4. GitHub API

• 如果要以编程方式完成此任务，则需要此解决方案。这实际上是DownGit在后台使用的功能。使用GitHub的REST API，编写一个脚本，该脚本向内容端点发出GET请求。端点可被构造为如下：https://api.github.com/repos/:owner/:repo/contents/:path。替换占位符后，示例端点为：https://api.github.com/repos/babel/babel-eslint/contents/lib。这将为您提供该文件夹中存在的所有内容的JSON数据。数据具有您所需的一切，包括内容是否是文件夹或文件，下载URL（如果是文件）以及API端点（如果是文件夹）（以便您可以获取该文件夹的数据）。使用此数据，脚本可以递归地遍历目标文件夹中的所有内容，为嵌套文件夹创建文件夹，并下载每个文件夹的所有文件。查看DownGit的代码以获取灵感。

另一个具体示例：

就像我想从网址下载“ iOS Pro Geo”文件夹

https://github.com/alokc83/APRESS-Books-Source-Code-/ tree / master /％20Pro％20iOS％20Geo

我可以通过

svn checkout https://github.com/alokc83/APRESS-Books-Source-Code-/trunk/%20Pro%20iOS%20Geo

注意路径中的树干

编辑：（根据Tommie C的评论）

是的，使用export 而不是checkout可以得到干净的副本，而无需额外的git存储库文件。

svn export https://github.com/alokc83/APRESS-Books-Source-Code-/trunk/%20Pro%20iOS%20Geo

编辑：如果树/母版不在URL中，则将其分叉，它将在分叉URL中。

有一个名为Python3的pip包githubdl可以执行此操作*：

export GIT_TOKEN=1234567890123456789012345678901234567890123
pip install githubdl
githubdl -u http://github.com/foobar/test -d foo

项目页面在这里

*免责声明：我写了这个程序包。

这是SVN比Git更好的少数几个地方之一。

最后，我们倾向于以下三种选择：

1. 使用wget从GitHub抓取数据（使用原始文件视图）。
2. 让上游项目将所需的数据子集发布为构建工件。
3. 放弃并使用完整的结帐。在第一个版本中这是一个很大的成功，但是除非您获得大量流量，否则在后续版本中不会有太多麻烦。

如果您对Unix命令感到满意，则不需要特殊的依赖项或Web应用程序。您可以将压缩包下载为tarball，仅解压缩所需的文件。

示例（来自fontawesome子目录中的woff2文件）：

curl -L https://api.github.com/repos/FortAwesome/Font-Awesome/tarball | tar xz --wildcards "*/web-fonts-with-css/webfonts/*.woff2" --strip-components=3

• 有关链接格式的更多信息：https : //developer.github.com/v3/repos/contents/#get-archive-link （包括如何获取zip文件或特定的分支/引用）
• 保留路径（*/）的开头部分以匹配任何目录。Github使用名称中的commit ref创建了一个包装器目录，因此无法知道。
• 您可能希望与路径（上一个参数）中--strip-components的斜杠（/）数量相同。

这将下载整个tarball。如果必须避免这种情况，或者如果您想对GitHub服务器友好，请使用其他答案中提到的SVN方法。

您可以简单下载目录树：

git archive --remote git@github.com:foobar/Test.git HEAD:foo | tar xf -

但是，如果您打算将其签出，并且能够进行提交并将其推回原位，那么您就不能这样做。

只是为了扩大上面的答案，从真实的GitHub存储库到本地目录的真实示例是：

svn ls https://github.com/rdcarp/playing-cards/trunk/PumpkinSoup.PlayingCards.Interfaces

svn export https://github.com/rdcarp/playing-cards/trunk/PumpkinSoup.PlayingCards.Interfaces  /temp/SvnExport/Washburn

有时，一个具体的例子有助于阐明提议的替代方案。

在我的情况下，所有答案都无济于事。如果您正在为Windows开发，则可能没有svn。在许多情况下，不能指望用户安装Git或由于其他原因而不想下载整个存储库。回答了这个问题的一些人，例如Willem van Ketwich和Aztack，为完成这项任务提供了工具。但是，如果该工具不是针对您使用的语言编写的，或者您不想安装第三方库，则这些工具将无效。

但是，有一种更简单的方法。GitHub有一个API，可让您使用GET请求下载单个文件或整个目录的内容。您可以使用https://api.github.com/repos/:owner/:repo_name/contents/:path返回的JSON对象枚举目录中的所有文件的目录。枚举中包含指向文件原始内容（download_url参数）的链接。然后可以使用该URL下载该文件。

这是一个两步过程，需要能够发出GET请求，但这可以在几乎任何语言，任何平台上实现。它可以用来获取文件或目录。

我们的团队编写了一个bash脚本来执行此操作，因为我们不想在裸机服务器上安装SVN。

https://github.com/ojbc/docker/blob/master/java8-karaf3/files/git-download.sh

它使用github API，可以从命令行运行，如下所示：

git-download.sh https://api.github.com/repos/ojbc/main/contents/shared/ojb-certs

我使用linux所以，把它放在〜/ .bashrc中，甚至命名为：D $ HOME / .bashrc

git-dowloadfolder(){
a="$1"
svn checkout ${a/tree\/master/trunk}

}

然后用刷新外壳

source ~/.bashrc 

然后与git-downloadfolder blablabla一起使用：D

我使用的CentOS 7服务器没有root访问权限，也没有git，svn等（也不想！），因此制作了一个python脚本来下载任何github文件夹：https : //github.com/andrrrl/github -文件夹下载器

用法很简单，只需从github项目中复制相关部分，假设该项目为https://github.com/MaxCDN/php-maxcdn/，并且您需要一个仅包含一些源文件的文件夹，那么您需要做类似的事情：

$ python gdownload.py "/MaxCDN/php-maxcdn/tree/master/src" /my/target/dir/
（如果不存在，将创建目标文件夹）

它需要lxml库，可以与一起安装。easy_install lxml
如果您没有root访问权限（例如我），则可以.pydistutils.py在$HOME目录中创建一个包含以下内容的文件： [install] user=1 并且easy_install lxml可以正常工作（参考：https : //stackoverflow.com/a/ 33464597/591257）。

只需走5步

1）从此处下载SVN。 2）打开CMD并转到SVN bin目录，如下所示：

cd %ProgramFiles%\SlikSvn\bin

3）假设我婉下载此目录网址 4）现在更换 随着 5）现在，在同一个目录下火最后一条命令来下载文件夹。

https://github.com/ZeBobo5/Vlc.DotNet/tree/develop/src/Samples

tree/develop
or
tree/master

trunk

svn export https://github.com/ZeBobo5/Vlc.DotNet/trunk/src/Samples

要从GitHub导出目录，请将目录网址中的“ / tree / master /”替换为“ / trunk /”。

例如，要从以下URL导出目录：

https://github.com/liferay/liferay-plugins/tree/master/portlets/sample-hibernate-portlet

运行以下命令：

svn export https://github.com/liferay/liferay-plugins/trunk/portlets/sample-hibernate-portlet

一个简单的答案是先从下面的链接开始乌龟svn。

https://tortoisesvn.net/downloads.html

在安装时，请打开CLI选项，以便可以从命令行界面使用它。

复制git hub子目录链接。

例

https://github.com/tensorflow/models/tree/master/research/deeplab

用树干替换树/主树

https://github.com/tensorflow/models/trunk/research/deeplab

并做

svn结帐https://github.com/tensorflow/models/trunk/research/deeplab

文件将下载到当前目录的deeplab文件夹中。

您可以通过以下方式使用git svn。

git svn clone https://github.com/lodash/lodash/trunk/test

这样，您就不必特别为Windows用户设置svn。

如果您需要以编程方式进行操作并且不想依赖SVN，则可以使用GitHub API递归下载所有内容。

为了获得灵感，这是我的红宝石要点：https : //gist.github.com/cvengros/b2a7e82f66519d423b6f

使用此功能，第一个参数是文件夹的URL，第二个参数是将文件夹下载到的位置：

function github-dir() {
    svn export "$(sed 's/tree\/master/trunk/' <<< "$1")" "$2"  
}

git clone --filter 从Git 2.19

此选项实际上将跳过从服务器获取不需要的对象的操作：

git clone --depth 1 --no-checkout --filter=blob:none \
  "file://$(pwd)/server_repo" local_repo
cd local_repo
git checkout master -- mydir/

服务器应配置为：

git config --local uploadpack.allowfilter 1
git config --local uploadpack.allowanysha1inwant 1

v2.19.0中对Git远程协议进行了扩展以支持此功能，但当时不支持服务器。但是它已经可以在本地测试。

我已经在以下文章中进行了详细介绍：如何仅克隆Git存储库的子目录？

无论出于何种原因，该svn解决方案都不适合我，并且由于我不需要svn其他任何东西，因此花时间尝试制作该解决方案也没有任何意义，因此我寻找了一个使用已有工具的简单解决方案。该脚本仅使用curl和awk下载描述为的GitHub目录中的所有文件"/:user:repo/contents/:path"。

调用GitHub REST API "GET /repos/:user:repo/contents/:path"命令返回的主体 返回一个对象，该对象包含"download_url"目录中每个文件的链接。

此命令行脚本使用REST API进行调用，curl并通过AWK发送结果，AWK过滤掉除“ download_url”行以外的所有行，从链接中删除引号和逗号，然后使用另一个调用来下载链接以进行卷曲。

curl -s https://api.github.com/repos/:user/:repo/contents/:path | awk \
     '/download_url/ { gsub("\"|,", "", $2); system("curl -O "$2"); }'

git sparse-checkout

Git 2.25.0包括一个新的实验git sparse-checkout命令，该命令使现有功能更易于使用，并为大型存储库带来了一些重要的性能优势。（GitHub博客）

当前版本的示例：

git clone --filter=blob:none --sparse https://github.com/git/git.git
cd git
git sparse-checkout init --cone
git sparse-checkout add t

最为显着地

• --sparse仅将git存储库的顶级目录文件检出到工作副本中
• git sparse-checkout add t递增地添加/签出的t子文件夹git

其他要素

• git sparse-checkout init 做一些准备工作以启用部分签出
• --filter=blob:none通过仅下载必要的git对象来优化数据获取（请查看部分克隆功能以获取更多信息）
• --cone 还通过应用更多受限制的文件包含模式来提高性能

GitHub状态

GitHub在某些选择的存储库上启用了该功能后，仍在内部对其进行评估。[...] 随着功能的稳定和成熟，我们将不断向您更新其进度。（docs）