[Git] 如何拉取 GitHub 仓库的特定子目录
作为开发者，我们经常遇到只需要克隆大型仓库中某个子目录的场景。
Git 本身并不支持直接克隆子目录，但通过一些技巧可以实现类似效果。本文将介绍几种实用的方法，帮助获取目标代码。
为什么需要局部拉取？
- 节省时间和带宽：避免克隆整个仓库（尤其是大型仓库）。
- 减少磁盘占用：只保留需要的代码。
- 提高开发效率：快速获取目标模块。
方法一：使用 Git Sparse Checkout（推荐）
这是 Git 原生支持的方案，适合需要后续同步更新的场景。
操作步骤
-
初始化稀疏克隆
使用--filter=blob:none和--sparse参数：git clone --filter=blob:none --sparse <仓库URL> -
进入仓库并初始化稀疏检出
cd <仓库名> && git sparse-checkout init --cone -
切换到目标分支
git checkout <分支名> -
设置要检出的子目录
git sparse-checkout set <子目录路径> -
验证结果
ls -la <子目录路径>
技术原理
--filter=blob:none：延迟下载文件内容（按需下载）。--sparse：启用稀疏检出模式。--cone：优化模式，提高大型仓库性能。
方法二：使用第三方工具
对于只需要一次性下载的场景，可以使用以下工具：
npx github-downsub <仓库URL>/tree/<分支名>/<子目录路径>
方法三：手动下载 ZIP（临时方案）
直接通过 GitHub 界面：
- 访问目标目录页面。
- 点击 “Download” 按钮。
- 解压后手动清理不需要的文件。
对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| Sparse Checkout | 可后续更新，Git原生支持 | 步骤稍复杂 |
| 第三方工具 | 简单快捷 | 依赖外部工具 |
| 手动下载 ZIP | 无需技术知识 | 无法同步更新 |
建议
- 长期项目：使用
Sparse Checkout。 - 快速获取：使用第三方工具或手动下载。
- 注意分支：确保切换到正确的分支。
后话
Sparse Checkout 方案，虽然需要多几步操作，但能为后续开发维护带来很大便利。
小技巧：可以将这些命令封装成 shell 脚本或 git alias，方便重复使用！