
Pernahkah anda menyertai projek laman web statik atau blog yang hanya mempunyai beberapa puluh halaman HTML dan Markdown, tetapi apabila menjalankan git clone, proses muat turun mengambil masa hampir lima minit dan saiz folder .git mencecah 1.5GB?
Puncanya hampir selalu sama: beberapa bulan sebelum itu, seseorang memasukkan folder gambar resolusi asal kamera (DSC_001.jpg, 8MB sekeping), tangkap layar PNG tanpa mampatan, atau video demo MP4 terus ke dalam Git. Apabila laman web terasa berat, mereka mengecilkan gambar tersebut dan memadamkan fail asal dalam commit baharu. Folder kerja kini kelihatan ringan, tetapi setiap orang yang mengklon repositori itu masih terpaksa memuat turun keseluruhan fail gergasi tadi.
Sebabnya mudah: Git menyimpan sejarah penuh, bukan keadaan folder semasa sahaja. Memadam fail dalam commit hari ini cuma menambah catatan bahawa fail itu tidak lagi wujud pada versi terkini; objek asal bersaiz 8MB itu masih tersimpan rapat di dalam .git/objects dan ikut dihantar setiap kali git clone dijalankan.
Periksa dahulu apa yang sebenarnya memakan ruang
Sebelum meneka-neka atau terus menyalahkan folder tertentu, ukur saiz repositori secara objektif. Anda boleh mula dengan melihat jumlah saiz objek Git:
git count-objects -vH
Jika size-pack sudah mencecah ratusan megabait atau gigabait, semak objek blob terbesar dalam sejarah dengan arahan ini:
git rev-list --objects --all \
| git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \
| awk '/^blob/ && $3 > 1048576 {printf "%.2f MB\t%s\n", $3/1048576, $4}' \
| sort -nr | head -n 20
Senarai itu akan menunjukkan dengan tepat fail mana dalam sejarah commit lama yang menjadikan repositori perlahan—selalunya kombinasi fail PSD, arkib .zip, atau gambar mentah yang pernah dimasukkan secara tidak sengaja.
Sekat aset besar sebelum masuk ke commit
Cara paling murah mengurus media projek web ialah memastikan fail mentah tidak pernah menjejakkan kaki ke dalam Git sejak hari pertama. Untuk blog atau laman web syarikat, tukar gambar kepada WebP atau AVIF dan kecilkan lebar kepada saiz paparan web (biasanya 1200px hingga 1600px, sasarkan saiz fail di bawah 150KB) sebelum menjalankan git add. Contoh mudah menggunakan cwebp:
cwebp -q 82 -resize 1400 0 foto-asal.jpg -o assets/blog/foto-artikel.webp
Fail mentah seperti PSD, Figma eksport asal, atau gambar RAW kamera patut disimpan di Google Drive, storan NAS pejabat, atau bucket arkib berasingan—bukan di dalam repositori kod.
Untuk projek berpasukan, jangan bergantung pada disiplin manual semata-mata. Tambah semakan ringkas dalam hook pre-commit atau GitHub Actions supaya mana-mana Pull Request yang cuba memasukkan fail aset melebihi 500KB atau 1MB ditolak awal dengan mesej ralat yang jelas.
Bila patut guna storan objek atau Git LFS?
Jika laman web memang mengurus ratusan atau ribuan fail media, PDF katalog, atau video yang kerap berubah, tempat terbaiknya ialah storan objek seperti Cloudflare R2 atau Amazon S3 yang disambungkan terus ke CDN. Repositori Git kekal menyimpan kod, templat, dan teks artikel sahaja; masa build dan git clone juga kekal beberapa saat.
Pilihan lain ialah Git LFS (Large File Storage), yang menggantikan fail besar di dalam Git dengan fail penunjuk teks kecil. Namun fahami dahulu komprominya: setiap pembangun dan pelayan CI/CD perlu memasang serta mengaktifkan git lfs, dan platform seperti GitHub mengenakan had kuota storan serta jalur lebar percuma sebelum caj tambahan dikenakan.
Berhati-hati sebelum menulis semula sejarah Git
Bagaimana jika repositori sudah terlanjur berat? Alat seperti git filter-repo (pengganti moden kepada git filter-branch dan BFG Repo-Cleaner) memang boleh membuang fail besar daripada sejarah commit lama.
Namun menulis semula sejarah bermakna kesemua commit hash akan berubah. Untuk blog peribadi yang diurus seorang diri, kerja force-push dan mengklon semula folder tempatan mungkin selesai dalam 10 minit. Sebaliknya, dalam repositori pasukan yang aktif, ia menuntut penyelarasan: semua ahli perlu menghentikan kerja sementara, melakukan git clone baharu, dan bersedia jika pautan commit lama dalam tiket isu atau dokumentasi terputus. Jika saiz repo masih boleh ditahan, selalunya lebih bijak membetulkan aliran kerja imej baharu dahulu, dan menjadualkan pembersihan sejarah hanya apabila ia benar-benar melambatkan CI/CD.