作為開發者，我們經常遇到只需要克隆大型倉庫中某個子目錄的場景。
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，方便重復使用！
