Folder Kosong Terus? Cara Mengatasi Clone Submodule Gagal GitHub

Folder submodule kosong setelah clone biasanya berarti repo utama berhasil diunduh, tapi isi submodule belum diinisialisasi. Jalankan perintah init dan update ulang, lalu periksa akses ke repository submodule tersebut.

git submodule update --init --recursive

Penyebab Clone Submodule Gagal di GitHub

Git menangani repo utama dan submodule sebagai dua repository berbeda. Clone utama bisa sukses sementara submodule tetap gagal.

  • URL di .gitmodules tidak bisa diakses, repository sudah dihapus, dipindah, atau berubah jadi private.
  • Akun kamu punya akses ke repo utama, tapi tidak punya akses ke repository submodule.
  • Autentikasi tidak konsisten. Repo utama di-clone pakai SSH, sedangkan submodule memakai HTTPS, atau sebaliknya.
  • Submodule menunjuk commit tertentu yang sudah dihapus atau history-nya ditulis ulang.

Tabel Troubleshooting Clone Submodule Gagal

Baca pesan error di terminal sebagai petunjuk awal. Bedakan origin milik repo utama dengan URL submodule yang tercatat di .gitmodules.

Masalah Penyebab Solusi
Folder kosong Belum init Jalankan update init recursive
Authentication failed Credential beda Samakan SSH atau HTTPS
Repository not found Akses kurang Minta akses submodule

Cara Memperbaiki Clone Submodule yang Gagal

  1. Periksa konfigurasi submodule dan pastikan URL masih benar.
    cat .gitmodules
    git submodule status
  2. Pastikan kamu bisa membuka repository submodule di GitHub dengan akun yang sama.
  3. Inisialisasi ulang semua submodule yang kosong.
    git submodule update --init --recursive
  4. Untuk clone baru, unduh repo utama beserta submodulenya sekaligus.
    git clone --recurse-submodules <URL-REPO-UTAMA>
  5. Kalau remote berubah dari HTTPS ke SSH atau sebaliknya, perbarui URL submodule.
    git submodule set-url <path-submodule> <URL-baru>
    git submodule sync
    git submodule update --init --recursive

FAQ

Kenapa folder submodule kosong setelah clone?

Karena git clone biasa hanya mengunduh repo utama tanpa mengisi isi submodule.

Apakah submodule perlu akses terpisah dari repo utama?

Ya, Git meminta izin terpisah untuk setiap repository submodule, terutama yang private.

Kapan memakai clone ulang –recurse-submodules?

Pakai saat kamu butuh salinan baru yang langsung menyertakan semua isi submodule.