Hemat Kuota dengan Cara Clone Hanya Satu Folder GitHub Via Sparse-Checkout

Cara clone hanya satu folder GitHub yang paling hemat kuota memakai sparse-checkout. Git tetap mengunduh metadata repository dari GitHub, tetapi hanya folder yang kamu pilih yang muncul di working directory. Pola perintahnya clone –filter, lalu sparse-checkout set ke path folder target.

Jawaban Cepat: Git Tidak Clone Satu Folder Saja

Git bekerja pada level repository, bukan level folder. Perintah checkout parsial tidak membuat repository baru berisi satu folder.

  • Metadata repository tetap ter-clone, file kerja yang dibatasi.
  • Metode utama untuk kebutuhan ini adalah sparse-checkout.
  • Alternatif tanpa Git adalah mengunduh direktori lewat antarmuka web GitHub.

Cara Clone Hanya Satu Folder GitHub dengan Sparse-Checkout

Kesalahan paling umum adalah menulis path folder dengan huruf besar kecil yang salah. Git membedakan Docs dan docs.

  1. Clone repository dengan filter blob agar hemat unduhan awal.
  2. Aktifkan sparse-checkout di dalam folder clone.
  3. Tentukan folder target dengan path relatif dari root.
  4. Tarik file folder tersebut dengan pull.
git clone --filter=blob:none --sparse https://github.com/OWNER/REPO.git
cd REPO
git sparse-checkout set nama-folder
git pull origin main
  • Gunakan Git 2.25 atau lebih baru agar perintah sparse-checkout tersedia.
  • Untuk repository privat, siapkan autentikasi HTTPS dengan PAT atau SSH sebelum clone.
  • Ganti main dengan nama branch remote yang benar.

Perbandingan Metode Ambil Satu Folder

Command Fungsi Catatan
sparse-checkout Batasi file kerja Hemat kuota, tetap terhubung remote
–depth 1 Clone dangkal Riwayat pendek, semua folder ikut
Unduh web Ambil folder tanpa Git Praktis, tanpa history dan pull
gh Akses repo via CLI Perlu autentikasi GitHub CLI
  • Pilih sparse-checkout bila kuota terbatas tetapi kamu masih perlu pull berkala.
  • Pilih clone penuh bila perlu seluruh riwayat commit dan semua branch.
  • Batasan penting: remote tetap origin, history bisa tidak lengkap, dan branch lain tetap perlu checkout terpisah.

Error Umum Saat Batasi Folder Clone

  • Folder hasil clone kosong karena path salah atau beda huruf besar kecil.
  • Perintah sparse-checkout tidak dikenal karena versi Git terlalu lama.
  • Untuk menambah atau mengganti folder, jalankan ulang git sparse-checkout set dengan daftar folder baru, lalu pull.
git sparse-checkout set folder-pertama folder-kedua
git pull origin main

FAQ

Apakah bisa clone satu folder tanpa clone repo?

Tidak. Git tetap clone repository, hanya isi working directory yang dibatasi.

Bagaimana cara menambah folder lain setelah sparse-checkout?

Jalankan ulang git sparse-checkout set dengan semua folder yang diinginkan.

Apakah sparse-checkout mengubah branch remote?

Tidak. Perintah ini hanya mengatur file lokal, branch di remote tetap sama.