Cara menyemak dan membersihkan cache Hugging Face pada Mac
Pasukan AskClean · Dikemas kini 2026-09-29
Kenal pasti cache yang benar-benar digunakan aplikasi, semak dengan hf cache ls dan pratonton sasaran tertentu melalui hf cache rm --dry-run. Kekalkan model yang diperlukan luar talian dan kerja sendiri. Jangan padam blob bersama secara manual atau seluruh HF_HOME.
Cari lokasi dan lindungi kerja sendiri
Lokasi biasa ialah ~/.cache/huggingface/hub. HF_HUB_CACHE memilih cache repositori, manakala HF_HOME meliputi lebih banyak data. Tanpa HF_HOME, XDG_CACHE_HOME boleh mempengaruhi lokasi lalai; cache_dir boleh memilih laluan lain. Semak aplikasi grafik, terminal dan notebook secara berasingan. HF_HOME mungkin menyimpan maklumat pengesahan: jangan padam semuanya atau terbitkan kandungannya.
Checkpoint yang ditala, adapter, perubahan tokenizer, hasil penukaran, data peribadi dan tetapan projek mungkin tidak boleh dimuat turun semula. Sahkan sandaran kerana sesetengah alat melangkau cache bertanda CACHEDIR.TAG. Simpan kandungan yang belum jelas cara pemulihannya; tarikh akses lama tidak membuktikan model tidak berguna.
Paparkan ID penuh dan amaran
Hentikan aplikasi, muat turun dan tugas yang menggunakan cache. Jalankan hf cache ls --no-truncate, kemudian hf cache ls --revisions --no-truncate --show-warnings. Versi diuji menyembunyikan amaran terperinci secara lalai. Gunakan --cache-dir yang sama bagi lokasi tersuai dalam setiap arahan. Siasat masalah bacaan atau struktur, catat ruang digunakan dan kosong, dan jangan dedahkan senarai repositori peribadi.
Semak skop sebelum mengesahkan
hf cache rm memerlukan ID penuh daripada CLI. Kekalkan awalan model/ untuk repositori model; nama folder bermula models-- bukan penggantinya. Untuk satu revisi, gunakan hash penuh dan semak repositorinya. Mulakan dengan --dry-run. Output ialah ringkasan sasaran dan anggaran ruang, bukan senarai setiap fail. Sasaran repositori merangkumi semua revisinya dalam cache.
Selepas semakan, buang hanya --dry-run dengan sasaran, laluan dan soalan pengesahan yang sama. Jika pilihan berubah atau pratonton gagal, hentikan pemadaman dan cari puncanya. Fail dipadam terus tanpa Sampah; pemulihan memerlukan sandaran atau akses muat turun semula. Snapshot dan sesetengah struktur repositori berkongsi blob. Biarkan pengurus cache mengendalikan rujukan dan jangan terus menjumlahkan saiz yang dipaparkan.
Bezakan prune daripada cache lain
Dalam versi 2.0.0 yang diuji, hf cache prune --dry-run menunjukkan revisi detached dan muat turun belum selesai. Projek masih boleh menetapkan revisi tertentu walaupun tiada rujukan bernama. Semak setiap sasaran dan hentikan muat turun aktif. Mulakan dengan satu item yang jelas.
Data yang dijana dalam HF_DATASETS_CACHE berbeza daripada muat turun Hub. Semak data pemindahan Xet dan output local_dir secara berasingan, sambil mengekalkan perubahan setempat. Memadam seluruh HF_HOME bukan pengganti semakan ini.
Muatkan model yang dikekalkan
Ulang pengukuran, muatkan model serta revisi yang diperlukan dan jalankan tugas kecil dengan hasil yang diketahui. Mengimport pustaka Python sahaja tidak mencukupi. Uji penggunaan luar talian dengan benar-benar memutuskan rangkaian. Jika gagal, hentikan pembersihan dan semak persekitaran, laluan, fail, akses serta ruang sebelum pemulihan. Muat turun berulang model penting menunjukkan pilihan atau kapasiti perlu dinilai semula.
Apabila berpindah ke cakera luaran, semak ruang, kebenaran dan sokongan pautan simbolik. Salin pautan bersama sasarannya, tetapkan setiap aplikasi dan uji model sebelum membuang salinan asal. Cakera mesti terus disambungkan semasa digunakan.
Skop pengesahan
Pada 2026-09-29, cache sintetik sementara diuji luar talian dengan huggingface_hub 2.0.0: senarai, ID penuh, amaran dan dry-run. Pratonton tidak mengubah fail; membuang revisi lama mengekalkan revisi semasa dan data bersama. Inferens sebenar, cache pengguna, pembersihan blob merentas repositori dan migrasi cakera tidak diuji. Tiada jaminan jumlah ruang tetap. Semak versi anda melalui hf cache --help.
Semak sebelum memadam
Pastikan lokasi sebenar, kegunaan dan cara memulihkan setiap item. Jadual ini bukan senarai pemadaman automatik dan tidak menjanjikan jumlah ruang tertentu.
| Item | Tempat semakan | Kesan dan syarat |
|---|---|---|
| Repositori atau revisi | hf cache ls --revisions | Sahkan skop tepat dan akses muat turun pada masa hadapan. |
| Data bersama | blob / snapshot | Serahkan rujukan kepada pengurus; jangan jumlahkan saiz secara terus. |
| Revisi detached | hf cache prune --dry-run | Projek mungkin masih memerlukan versi yang tepat ini. |
| Set data yang dijana | HF_DATASETS_CACHE | Penjanaan semula memerlukan sumber data dan masa pemprosesan. |
| Model dan kerja sendiri | checkpoint / adapter | Simpan yang asal dan semak kandungan sebenar sandaran. |
| Direktori utama Hugging Face | HF_HOME | Mungkin mengandungi maklumat pengesahan; jangan padam keseluruhannya. |
Soalan Lazim
Adakah revisi detached sudah tidak digunakan?
Tidak semestinya. Projek boleh menetapkan revisi tepat tanpa rujukan bernama dalam cache. Semak kebergantungan dahulu.
Bolehkah hf cache rm memadam model yang saya tala?
Ya, jika model berada dalam sasaran dipilih. Simpan di luar skop pemadaman dan sahkan sandarannya. Nama cache tidak menjadikan kerja anda boleh dibuang begitu sahaja.
Sumber