[Git] 如何拉取 GitHub 仓库的特定子目录

作为开发者，我们经常遇到只需要克隆大型仓库中某个子目录的场景。

Git 本身并不支持直接克隆子目录，但通过一些技巧可以实现类似效果。本文将介绍几种实用的方法，帮助获取目标代码。

为什么需要局部拉取？

• 节省时间和带宽：避免克隆整个仓库（尤其是大型仓库）。
• 减少磁盘占用：只保留需要的代码。
• 提高开发效率：快速获取目标模块。

方法一：使用 Git Sparse Checkout（推荐）

这是 Git 原生支持的方案，适合需要后续同步更新的场景。

操作步骤

1. 初始化稀疏克隆

   使用 --filter=blob:none 和 --sparse 参数：

   git clone --filter=blob:none --sparse <仓库URL>

2. 进入仓库并初始化稀疏检出

   cd <仓库名> && git sparse-checkout init --cone

3. 切换到目标分支

   git checkout <分支名>

4. 设置要检出的子目录

   git sparse-checkout set <子目录路径>

5. 验证结果

   ls -la <子目录路径>

技术原理

• --filter=blob:none：延迟下载文件内容（按需下载）。
• --sparse：启用稀疏检出模式。
• --cone：优化模式，提高大型仓库性能。

方法二：使用第三方工具

对于只需要一次性下载的场景，可以使用以下工具：

npx github-downsub <仓库URL>/tree/<分支名>/<子目录路径>

方法三：手动下载 ZIP（临时方案）

直接通过 GitHub 界面：

1. 访问目标目录页面。
2. 点击 "Download" 按钮。
3. 解压后手动清理不需要的文件。

对比

方案	优点	缺点
Sparse Checkout	可后续更新，Git原生支持	步骤稍复杂
第三方工具	简单快捷	依赖外部工具
手动下载 ZIP	无需技术知识	无法同步更新

建议

1. 长期项目 ：使用 Sparse Checkout。
2. 快速获取：使用第三方工具或手动下载。
3. 注意分支：确保切换到正确的分支。

后话

Sparse Checkout 方案，虽然需要多几步操作，但能为后续开发维护带来很大便利。

小技巧：可以将这些命令封装成 shell 脚本或 git alias，方便重复使用！