Cara memeriksa dan membersihkan cache Hugging Face di Mac

Temukan lokasi dan lindungi pekerjaan Anda

Lokasi umum adalah ~/.cache/huggingface/hub. HF_HUB_CACHE memilih cache repositori; HF_HOME mencakup data lebih luas. Tanpa HF_HOME, XDG_CACHE_HOME dapat memengaruhi lokasi standar; cache_dir dapat memilih jalur lain. Periksa aplikasi grafis, terminal, dan notebook secara terpisah. HF_HOME bisa menyimpan autentikasi: jangan hapus seluruhnya atau publikasikan isinya.

Checkpoint hasil fine-tuning, adapter, perubahan tokenizer, konversi, data privat, dan konfigurasi mungkin tidak dapat diunduh ulang. Verifikasi cadangan karena sebagian alat melewatkan cache bertanda CACHEDIR.TAG. Simpan yang belum jelas cara pemulihannya; waktu akses lama saja tidak membuktikan model sudah tidak berguna.

Tampilkan ID lengkap dan peringatan

Hentikan aplikasi, unduhan, dan tugas yang menggunakan cache. Jalankan hf cache ls --no-truncate lalu hf cache ls --revisions --no-truncate --show-warnings. Versi yang diuji menyembunyikan peringatan terperinci secara bawaan. Selalu gunakan --cache-dir yang sama untuk lokasi khusus. Selidiki masalah baca atau struktur, catat pemakaian dan ruang kosong, dan jangan membagikan daftar repositori privat.

Tinjau cakupan sebelum mengonfirmasi

hf cache rm membutuhkan ID CLI lengkap. Pertahankan awalan model/ untuk repositori model, bukan nama folder berawalan models--. Untuk satu revisi, gunakan hash lengkap dan periksa repositorinya. Mulai dengan --dry-run. Keluaran merupakan ringkasan sasaran dan perkiraan ruang, bukan daftar setiap file. Sasaran repositori mencakup semua revisinya yang ada di cache.

Setelah diperiksa, hapus --dry-run dengan tetap memakai sasaran, jalur, dan permintaan konfirmasi yang sama. Jika pilihan berubah atau pratinjau gagal, hentikan penghapusan dan periksa penyebabnya. File dihapus langsung tanpa Tong Sampah; pemulihan memerlukan cadangan atau akses unduh kembali. Snapshot dan pada beberapa struktur repositori berbagi blob. Serahkan referensi pada pengelola cache dan jangan menjumlahkan ukuran tampilan begitu saja.

Bedakan prune dan cache lain

Pada versi 2.0.0 yang diuji, hf cache prune --dry-run menampilkan revisi detached dan unduhan yang belum selesai. Tanpa referensi bernama, proyek tetap bisa menetapkan revisi tertentu. Periksa setiap sasaran dan hentikan unduhan aktif. Mulailah dengan satu item yang jelas.

Data yang dihasilkan dalam HF_DATASETS_CACHE berbeda dari unduhan Hub. Periksa transfer Xet dan keluaran local_dir terpisah, sambil menjaga perubahan lokal. Menghapus seluruh HF_HOME tidak menggantikan pemeriksaan ini.

Muat model yang dipertahankan

Ulangi pengukuran, muat model dan revisi yang diperlukan, lalu jalankan tugas kecil dengan hasil yang diketahui. Mengimpor pustaka Python saja tidak cukup. Uji penggunaan offline dengan benar-benar memutus jaringan. Jika gagal, hentikan pembersihan dan periksa lingkungan, jalur, file, akses, dan ruang sebelum pemulihan. Terus mengunduh ulang model penting berarti sasaran atau kapasitas perlu ditinjau.

Saat pindah ke disk eksternal, periksa ruang, izin, dan dukungan tautan simbolik. Salin tautan bersama sasarannya, atur setiap aplikasi, dan uji modelnya sebelum menghapus salinan asli. Disk harus tetap tersambung saat digunakan.

Cakupan pengujian

Pada 2026-09-29, cache sintetis sementara diuji offline dengan huggingface_hub 2.0.0: daftar, ID lengkap, peringatan, dan dry-run. Pratinjau tidak mengubah file; penghapusan revisi lama mempertahankan revisi aktif dan data bersama. Inferensi nyata, cache pengguna, pembersihan blob lintas repositori, dan migrasi disk tidak diuji. Tidak ada jaminan ruang tetap. Periksa versi Anda dengan hf cache --help.

Periksa sebelum menghapus

Pastikan lokasi, kegunaan, dan cara memulihkan setiap item. Tabel ini bukan daftar penghapusan otomatis dan tidak menjanjikan jumlah ruang tertentu.

FAQ