Cara Memeriksa dan Membersihkan Cache Hugging Face di Mac
Tim AskClean · Diperbarui 2026-11-02
Untuk mengosongkan ruang cache Hugging Face di Mac, temukan cache yang benar-benar dipakai aplikasi Anda, periksa isinya dengan hf cache ls, lalu pratinjau penghapusan satu repositori atau revisi dengan hf cache rm --dry-run. Simpan model yang dibutuhkan secara offline serta hasil kerja Anda sendiri. Jangan menghapus blob bersama atau seluruh folder HF_HOME tanpa pemeriksaan.

Temukan lokasi cache dan lindungi hasil kerja Anda
Lokasi cache Hub yang umum adalah ~/.cache/huggingface/hub. HF_HUB_CACHE langsung menentukan cache repositori Hub; HF_HOME mengubah direktori utama Hugging Face yang lebih luas, sedangkan XDG_CACHE_HOME dapat memengaruhi lokasi bawaan bila HF_HOME tidak ditetapkan. Argumen cache_dir di aplikasi juga bisa memilih jalur lain. Periksa aplikasi GUI, kernel notebook, dan proyek command-line secara terpisah karena pengaturan lingkungannya bisa berbeda; direktori Hub bawaan yang kosong tidak berarti tidak ada model di Mac Anda. HF_HOME juga bisa berisi data autentikasi: jangan menghapus seluruh direktorinya, dan jangan menyertakan berkas autentikasi atau daftar repositori privat saat meminta bantuan.
Pisahkan unduhan dari artefak buatan Anda sendiri: checkpoint hasil fine-tuning, adapter, perubahan tokenizer, hasil konversi, dataset privat, notebook, prompt, dan konfigurasi proyek mungkin hanya ada di Mac ini dan tidak bisa diunduh ulang. Cadangkan dan verifikasi semuanya sebelum mengosongkan penyimpanan yang terkait model; sebagian alat pencadangan melewatkan cache bertanda CACHEDIR.TAG. Jika Anda belum tahu cara memulihkan sebuah item dan membuat aplikasinya berjalan lagi, simpan dulu item itu. Waktu akses yang sudah lama saja tidak membuktikan model sudah tidak dipakai.
Tampilkan ID lengkap dan peringatan
Tutup aplikasi, unduhan, dan tugas yang memakai cache tersebut. Jalankan hf cache ls --no-truncate untuk melihat ID repositori lengkap, lalu hf cache ls --revisions --no-truncate --show-warnings untuk melihat hash revisi lengkap dan masalah cache; pada versi yang diuji, peringatan terperinci disembunyikan secara bawaan. Untuk cache Hub khusus, berikan nilai --cache-dir yang sama pada setiap perintah. Selidiki entri yang tidak terbaca atau tidak konsisten sebelum menghapus, pilih sasaran yang spesifik, periksa revisi yang dipatok (pinned) di kode dan konfigurasi, lalu catat ukuran direktori dan ruang kosong. Jangan membagikan keluaran yang memuat nama proyek rahasia.
Tinjau cakupan sebelum mengonfirmasi
hf cache rm membutuhkan ID repositori atau hash revisi lengkap dari inventaris Anda. Untuk repositori model, pertahankan awalan model/ seperti yang ditampilkan CLI; nama folder di disk yang berawalan models-- bukan ID yang sama. Untuk satu revisi, gunakan hash lengkapnya dan periksa repositori pemiliknya. Mulailah dengan --dry-run: keluarannya berupa ringkasan sasaran dan perkiraan ruang yang kembali, bukan daftar setiap berkas. Memilih repositori berarti mencakup semua revisinya di cache, jadi gunakan sasaran revisi jika Anda hanya ingin menghapus satu revisi.
Setelah cakupannya diperiksa, ulangi perintah yang sama tanpa --dry-run, dengan sasaran dan direktori cache yang sama, dan biarkan permintaan konfirmasi tetap aktif sebagai pemeriksaan terakhir. Jika daftarnya berubah tanpa diduga atau pratinjau gagal, hentikan dan selidiki penyebabnya. Penghapusan cache langsung menghapus berkas, tidak memindahkannya ke Tong Sampah; untuk memulihkan revisi yang terhapus, Anda butuh cadangan yang berfungsi atau unduhan ulang. Snapshot dapat berbagi data, dan pada beberapa struktur cache blob dipakai bersama lintas repositori: biarkan pengelola cache Hugging Face menangani blob bersama dan referensi snapshot, jangan menghapus berkas satu per satu di Finder, dan jangan menjumlahkan ukuran revisi yang ditampilkan begitu saja.
Bedakan prune dan cache lain
Pada CLI 2.0.0 yang diuji, hf cache prune --dry-run menampilkan revisi detached dan unduhan yang belum selesai. Revisi detached tidak memiliki referensi bernama di cache, tetapi proyek Anda mungkin masih meminta revisi persis itu — periksa proyek sebelum menyetujui penghapusannya. Untuk pembersihan pertama, satu penghapusan eksplisit lebih mudah dievaluasi daripada prune menyeluruh. Jika kelak Anda memakai prune, terapkan pemeriksaan yang sama pada semua kandidat dan hentikan dulu proses yang sedang mengunduh; berkas yang belum selesai belum tentu transfer yang ditinggalkan.
Cache Hugging Face Datasets (HF_DATASETS_CACHE) dapat menyimpan data hasil pemrosesan yang tidak ikut terhapus bersama unduhan Hub. Unduhan dengan local_dir berada di tujuan yang dipilih oleh Anda atau aplikasi; perlakukan terpisah dari cache Hub bersama, dan simpan dulu skrip atau berkas yang sudah Anda ubah, karena unduhan baru tidak mengembalikan suntingan lokal. Penyimpanan transfer Xet juga terpisah. Menghapus revisi Hub belum tentu mengosongkan kategori-kategori ini, dan menghapus seluruh HF_HOME bukan pengganti pemeriksaan per kategori.
Pastikan model yang dipertahankan masih berfungsi
Ulangi inventaris dan pengukuran disk, lalu muat model dan revisi yang ingin Anda pertahankan dan jalankan tugas kecil dengan hasil yang sudah diketahui; sekadar mengimpor pustaka Python tidak memeriksa berkas model. Jika Anda butuh akses offline, uji dengan jaringan benar-benar terputus. Jika pemeriksaan gagal, hentikan pembersihan, catat model, revisi, jalur cache, dan galatnya, lalu pastikan aplikasi memakai lingkungan yang Anda periksa sebelum memulihkan cadangan atau mengunduh ulang revisi yang dibutuhkan. Selesaikan kegagalan itu sebelum menghapus entri lain. Jika model yang sama terus terunduh lagi, tinjau kembali pilihan sasaran, kapasitas, atau lokasi cache.
Jika model yang rutin Anda pakai melebihi kapasitas Mac, disk eksternal bisa membantu. Periksa ruang kosong, izin, dan dukungan tautan simbolik yang menghubungkan snapshot ke blob bersama; pertahankan tautan itu beserta berkas tujuannya saat menyalin. Atur setiap aplikasi agar memakai lokasi baru dan uji model yang diperlukan di sana sebelum menghapus salinan asli. Disk harus tetap tersambung setiap kali aplikasi tersebut membutuhkannya.
Cara kami memeriksa perintah ini
Pada 2026-09-29 kami membuat cache bergaya Hub sementara secara offline, berisi dua revisi sintetis dengan satu blob bersama dan satu blob khusus per revisi. Dengan huggingface_hub 2.0.0, daftar revisi berhasil ditampilkan, dry run rm dan prune tidak mengubah apa pun, dan penghapusan revisi lama mempertahankan revisi saat ini beserta data bersamanya sambil menghapus blob khusus milik revisi lama. Pemeriksaan kedua memastikan --show-warnings menampilkan entri cache yang sengaja dirusak dan --no-truncate mempertahankan ID revisi lengkap. Pengujian ini tidak mencakup unduhan model sungguhan, inferensi, cache pengguna, migrasi disk, atau blob yang dipakai bersama lintas repositori, dan tidak memprediksi berapa gigabyte yang akan kembali. Jalankan hf cache --help lebih dulu; jika versi Anda menawarkan perintah atau opsi yang berbeda, ikuti dokumentasinya.
AskClean dapat membantu Anda melihat ke mana penyimpanan Mac terpakai. Pemindaian dan pratinjau gratis; analisis AI dan pembersihan memerlukan Pro. Pembersihan disk menghapus item yang Anda konfirmasi secara permanen. Gunakan CLI Hugging Face untuk mengelola revisi di cache beserta berkas bersamanya, dan jangan masukkan hasil kerja proyek asli ke pilihan pembersihan.
Yang bisa dibuat ulang dan yang harus disimpan
Periksa setiap kategori secara terpisah. Tabel ini menjelaskan apa yang perlu disimpan atau dipulihkan; tabel ini tidak menandai berkas untuk dihapus otomatis.
| Item | Tempat memeriksa | Yang diperiksa sebelum menghapus |
|---|---|---|
| Repositori atau revisi Hub | hf cache ls --revisions | Periksa pilihan yang persis. Memulihkannya mungkin butuh unduhan ulang dan akses ke repositori yang sama. |
| Blob dan snapshot bersama | Cache Hub yang sudah dipastikan | Gunakan pengelola cache; revisi—dan pada beberapa struktur, repositori—dapat berbagi berkas yang sama. |
| Revisi detached | hf cache prune --dry-run | Proyek mungkin masih membutuhkan revisi persis itu meski cache tidak punya referensi bernama untuknya. |
| Cache dataset hasil pemrosesan | HF_DATASETS_CACHE / pengaturan cache Datasets | Terpisah dari unduhan Hub; membuatnya ulang mungkin butuh waktu pemrosesan dan data sumber. |
| Checkpoint, adapter, dan sumber kustom | Lokasi proyek dan cadangan Anda | Simpan hasil kerja asli Anda. Pastikan cadangan mencakupnya, terutama jika tersimpan di bawah direktori cache. |
| Direktori utama Hugging Face dan data autentikasi | HF_HOME | Jangan menghapus seluruh direktori utama hanya untuk membuang entri cache model. |
Uji regresi lokal memakai cache sintetis yang sangat kecil. Ukuran fixture itu bukan tolok ukur atau perkiraan penghematan di dunia nyata.
FAQ
Bolehkah saya menghapus ~/.cache/huggingface di Mac?
Jangan anggap seluruh direktori itu sekali pakai. Temukan cache Hub yang aktif, simpan data autentikasi dan hasil kerja asli, lalu pratinjau penghapusan repositori atau revisi tertentu dengan perintah hf cache yang terpasang.
Mengapa menghapus satu revisi membebaskan ruang lebih kecil dari ukuran yang ditampilkan?
Revisi dapat berbagi berkas, dan pada beberapa struktur cache juga lintas repositori. Periksa perkiraan di pratinjau, lalu bandingkan pemakaian disk dan ruang kosong sebelum dan sesudahnya. Menjumlahkan ukuran revisi yang ditampilkan bisa menghitung berkas yang sama lebih dari sekali.
Apakah revisi detached berarti tidak ada aplikasi yang memakainya?
Tidak. Proyek bisa mematok revisi persis meski tidak ada referensi bernama di cache. Periksa kebutuhan proyek sebelum menjalankan prune.
Apakah model saya tetap bisa dipakai offline setelah pembersihan?
Hanya berkas cache yang dipertahankan dan lengkap yang bisa mendukung pekerjaan yang membutuhkannya. Uji pemuatan offline yang representatif sebelum menghapus cadangan atau mengandalkan Mac tanpa koneksi.
Bisakah hf cache rm menghapus model hasil fine-tuning saya?
Bisa, jika berkas kustom Anda berada di dalam entri cache yang dipilih. Simpan checkpoint, adapter, dan berkas yang diubah di luar entri yang akan dihapus, dan verifikasi cadangannya. Folder bernama cache pun bisa berisi satu-satunya salinan pekerjaan penting.
Sumber