如何仅从GitLab仓库下载指定分支下的目标文件夹内容？

目前你通过全量克隆仓库再切换分支、进入目标文件夹的方式虽然可行，但确实会浪费资源。Git本身没有git download这类命令，但有几种更高效的方式实现仅获取指定分支下的目标文件夹：

方法1：Git稀疏检出（Sparse Checkout） #

这是Git原生支持的轻量克隆方式，只拉取你需要的文件夹：

# 初始化空仓库
- git init temp-repo
- cd temp-repo
# 启用稀疏检出
- git config core.sparseCheckout true
# 指定要拉取的文件夹
- echo "desired/folder/" >> .git/info/sparse-checkout
# 添加远程仓库
- git remote add origin https://gitlab-ci-token:${TOKEN}@${repo}.git
# 拉取指定分支的内容，--depth=1可以只拉最新提交，进一步减少资源占用
- git pull origin desired-branch --depth=1
# 现在temp-repo下就只有desired/folder文件夹了
- ls desired/folder

方法2：通过GitLab API下载文件夹压缩包 #

GitLab提供了API可以直接下载指定分支下单个文件夹的压缩包，无需克隆仓库：

# 替换占位符：${PROJECT_ID}是目标仓库的项目ID，${FOLDER_PATH}是目标文件夹路径，${BRANCH}是分支名
- curl --header "PRIVATE-TOKEN: ${TOKEN}" \
  "https://gitlab.com/api/v4/projects/${PROJECT_ID}/repository/archive.zip?path=${FOLDER_PATH}&sha=${BRANCH}" \
  -o folder-archive.zip
# 解压压缩包
- unzip folder-archive.zip
# 解压后会生成带仓库名和分支哈希的文件夹，里面就是目标文件夹内容
- ls */desired/folder

方法3：Git子模块（适合长期依赖场景） #

如果你的项目需要长期依赖该文件夹，可以用子模块只拉取指定分支的特定路径：

# 添加子模块时指定分支和路径
- git submodule add --branch desired-branch --name desired-folder https://gitlab-ci-token:${TOKEN}@${repo}.git ./desired-folder
# 初始化子模块并拉取内容，--depth=1减少资源占用
- git submodule update --init --depth=1

内容的提问来源于stack exchange，提问作者user19451321