DownGit

定义

DownGit是一个运行在浏览器中的网页工具，作用是把GitHub上某个公开文件或目录打包成一个ZIP压缩包，供用户直接下载，或为它生成一条可复用的下载链接^[1]。它不需要在浏览器中安装插件，也不需要在本地安装Git，用户把目标文件或目录的网页地址粘贴进输入框、点击下载按钮即可^[2]。

这一工具针对的是Git在设计上以整个仓库为单位的特性：标准的克隆命令会把全部提交历史和全部分支一并取回，而GitHub网页界面也没有提供只导出某个子目录的入口^[3]。DownGit因此被归为社区开发的第三方网页工具，与同类的浏览器扩展一起，用于从远端仓库中定向提取少量内容^[3]。

原理

DownGit 本身是一个前端网页应用，代码以 JavaScript 为主，托管在代码托管平台的静态页面上，打包过程在浏览器一侧完成^[4]。用户粘贴的地址会被解析为仓库、分支和路径三部分，再被改写为对应的接口请求地址^[5]。

接口返回的内容中包含该目录下每个文件的下载地址，DownGit 再利用这些地址逐个取回文件，最后把所有文件按原有层级关系压缩进同一个压缩包^[5]。由于每条下载链接都携带参数，工具也支持把配置写进网址，典型形式为 url 指定目标路径、fileName 指定压缩包名称、rootDirectory 决定是否把目录本身也放进去^[1]。例如把 rootDirectory 设为 false，得到的压缩包内就不再包含同名的最外层目录^[1]。

由此发展出一种常见用法：把参数拼接成固定的下载链接，直接用命令行下载工具 curl 或 wget 请求，从而把目录打包嵌入脚本或自动化流程^[6]。

发展历程

DownGit 由 Minhas Kamal 开发，2016 年发布，采用 MIT 许可证开放源代码^[1][7]。开发者在其问答帖中说明，他既想下载整个目录，也想为这个目录生成一条直链，但没有找到满足需求的办法，于是自己动手实现了这一工具^[8]。

此后该工具在开发者社区中被反复推荐，成为从代码托管平台下载子目录时常用的在线方案之一^[9]。由于原项目的部分静态资源链接一度失效，社区中出现了多个把资源地址替换为其他镜像后重新发布的副本^[10]。此外，也曾有第三方利用该工具分发恶意程序，导致其在浏览器安全报告中被标记为有害，开发者给出的处理办法是由用户自行复刻项目并从自己的账号发布^[11]。

应用

DownGit 的典型场景是只取用大型仓库中的一小部分内容，例如下载文档目录、示例代码目录或图片资源目录，而不必取回整个项目^[12]。对于需要长期保存某个子目录的场合，也有人用它生成固定链接，供他人直接获取压缩包^[6]。

在缺少命令行环境的场合，它被作为不需要安装软件的可选方案列出，与 Git 的稀疏检出、命令行工具和浏览器扩展等做法并列^[13]。另有做法把项目源码下载到本地后自行部署，以内网方式使用该工具^[14]。

局限

DownGit 依赖代码托管平台的接口取回文件，接口本身设有匿名请求的次数上限，因此在频繁使用或目录体积较大时可能因超出限额而失败^[15]。有资料指出，当目录内文件数量过多时成功率会明显下降，社区经验认为文件数量在数百个左右的目录较为稳定^[3][16]。

该工具面向的是公开仓库，需要身份验证的私有仓库不在其支持范围内^[15]。作为第三方服务，它还需要由用户的浏览器直接向代码托管平台发起大量请求，密集请求可能被平台限流，出现请求被拒的情况^[16]。此外，它只提供一次性获取内容的压缩包，不具备版本控制能力，也不支持只取历史版本的子目录^[15]。

参见

• GitHub —— DownGit 所操作的代码托管平台，其网页界面不提供子目录导出功能。

• Git —— 该工具所绕开的版本控制系统，标准克隆以整个仓库为对象。

• JavaScript —— 该工具的主要实现语言。

• ZIP —— 该工具输出的文件压缩格式。

• 压缩包 —— DownGit 生成并交付给用户的文件形态。