AskClean

Cara mengosongkan cache Hugging Face pada Mac

Pasukan AskClean · Dikemas kini 2026-11-02

Untuk mendapatkan semula ruang cache Hugging Face pada Mac, kenal pasti cache yang digunakan oleh aplikasi anda, semak dengan hf cache ls, dan pratonton repositori atau revisi tertentu dengan hf cache rm --dry-run. Kekalkan model yang diperlukan untuk kerja luar talian serta kerja anda sendiri. Jangan padam blob yang dikongsi atau seluruh folder HF_HOME secara membuta tuli.

Ilustrasi konsep revisi model yang dipautkan kepada blok data bersama, dengan fail projek disimpan berasingan
Beberapa revisi boleh berkongsi fail yang sama. Simpan checkpoint dan kerja projek anda secara berasingan. Ilustrasi konsep.

Cari cache yang digunakan dan lindungi kerja anda

Cache Hub biasanya berada di ~/.cache/huggingface/hub. HF_HUB_CACHE memilih cache repositori Hub secara terus, manakala HF_HOME mengubah direktori utama Hugging Face yang lebih luas; jika HF_HOME tidak ditetapkan, XDG_CACHE_HOME boleh mempengaruhi lokasi lalai, dan argumen cache_dir dalam aplikasi boleh memilih laluan lain. Semak aplikasi GUI, kernel notebook dan projek baris perintah secara berasingan kerana tetapan persekitarannya mungkin berbeza — direktori Hub lalai yang kosong tidak bermakna tiada model pada Mac anda. HF_HOME juga boleh mengandungi data pengesahan, jadi jangan padam seluruh direktori itu, dan jangan kongsi fail pengesahan atau senarai repositori persendirian semasa meminta bantuan.

Asingkan muat turun daripada artifak yang anda cipta sendiri: checkpoint yang ditala halus, adapter, perubahan tokenizer, hasil penukaran, set data persendirian, notebook, prompt dan konfigurasi projek. Model asas yang dimuat turun mungkin boleh diperoleh semula, tetapi adapter atau resipi penukaran setempat mungkin hanya wujud pada Mac ini. Sandarkan dan sahkan kerja itu dahulu; sesetengah alat sandaran melangkau cache yang bertanda CACHEDIR.TAG, jadi pastikan sandaran anda benar-benar merangkumi fail yang diperlukan. Jika anda belum tahu cara memulihkan sesuatu item, simpan dahulu; usia atau tarikh akses lama sahaja bukan alasan untuk memadamnya.

Paparkan ID penuh dan amaran

Hentikan aplikasi, muat turun dan tugas yang menggunakan cache itu. Jalankan hf cache ls --no-truncate, kemudian hf cache ls --revisions --no-truncate --show-warnings untuk melihat hash revisi penuh dan sebarang masalah cache; dalam versi yang diuji, amaran terperinci disembunyikan secara lalai. Bagi cache Hub tersuai, gunakan nilai --cache-dir yang sama dalam setiap perintah. Siasat amaran tentang entri yang tidak boleh dibaca atau tidak konsisten sebelum membuang apa-apa, catat saiz direktori dan ruang kosong semasa, dan jangan dedahkan output jika ia menamakan projek sulit.

Pratonton pembuangan sebelum mengesahkannya

Gunakan hf cache rm dengan satu ID repositori atau hash revisi yang lengkap daripada inventori anda, dan tambah --dry-run dahulu. Bagi repositori model, kekalkan awalan model/ yang dipaparkan oleh CLI; nama folder yang bermula dengan models-- bukan pengecam yang sama. Bagi satu revisi, gunakan hash penuhnya dan semak repositori pemiliknya. Pratonton memaparkan ringkasan sasaran dan anggaran penjimatan ruang, bukan senarai setiap fail; sasaran repositori merangkumi semua revisinya dalam cache.

Selepas menyemak skop, jalankan semula perintah yang sama tanpa --dry-run, dengan sasaran dan direktori cache yang sama, dan biarkan gesaan pengesahan aktif untuk semakan terakhir. Jika senarai berubah tanpa dijangka atau pratonton gagal, hentikan dan siasat puncanya. Saiz yang dipaparkan bagi satu revisi boleh melebihi ruang yang benar-benar dibebaskan kerana snapshot boleh berkongsi data, dan dalam sesetengah susun atur, repositori juga berkongsi blob; biarkan pengurus cache mengendalikan rujukan itu dan jangan padam fail satu per satu dalam Finder. Pembuangan cache memadam fail secara terus, bukan ke Sampah: simpan sandaran sehingga semakan anda lulus, terutamanya bagi model persendirian, yang aksesnya terhad (gated), yang tidak lagi diterbitkan, diubah suai secara setempat atau diperlukan luar talian.

Bezakan prune daripada cache lain

Dalam CLI 2.0.0 yang diuji, hf cache prune --dry-run memaparkan revisi detached dan muat turun yang belum selesai. Revisi detached tidak mempunyai rujukan bernama dalam cache, tetapi projek anda mungkin masih meminta revisi tepat itu. Semak setiap calon, hentikan muat turun yang sedang berjalan, dan mulakan dengan satu pembuangan yang jelas sebelum pembersihan yang lebih luas.

Data yang dijana dalam HF_DATASETS_CACHE berbeza daripada muat turun Hub. Semak storan pemindahan Xet dan output local_dir secara berasingan, dan kekalkan perubahan setempat — muat turun baharu tidak akan memulihkan suntingan anda. Memadam seluruh HF_HOME bukan pengganti semakan ini.

Pastikan model yang dikekalkan masih berfungsi

Ulang inventori dan ukuran cakera, kemudian muatkan model serta revisi yang anda mahu kekalkan dan jalankan tugas kecil dengan hasil yang diketahui; mengimport pustaka Python sahaja tidak menguji fail model. Jika anda memerlukan akses luar talian, uji dengan rangkaian diputuskan. Jika semakan gagal, hentikan pembersihan, catat model, revisi, laluan cache dan ralat, kemudian pulihkan daripada sandaran atau muat turun semula selepas mengesahkan akses dan ruang. Jika model yang sama dimuat turun semula berulang kali, nilai semula pilihan, kapasiti storan atau lokasi cache anda.

Jika anda memindahkan cache ke cakera luaran, semak ruang kosong, kebenaran dan sokongan pautan simbolik. Salin pautan itu bersama fail sasarannya, tetapkan setiap aplikasi supaya menggunakan lokasi baharu, dan uji model yang diperlukan di situ sebelum membuang salinan asal. Cakera itu mesti terus disambungkan setiap kali aplikasi berkenaan memerlukannya.

Cara kami menyemak perintah ini

Pada 2026-09-29, kami menguji cache sintetik sementara secara luar talian dengan huggingface_hub 2.0.0: penyenaraian revisi, ID penuh, amaran dan dry run. Pratonton tidak mengubah fail, dan membuang revisi lama mengekalkan revisi semasa serta data yang dikongsi. Inferens sebenar, cache pengguna, pembersihan blob merentas repositori dan migrasi cakera tidak diuji, dan ujian ini tidak meramalkan jumlah gigabait yang akan dibebaskan pada Mac anda. Jalankan hf cache --help dalam persekitaran anda dahulu dan ikut dokumentasi versi anda jika perintahnya berbeza.

AskClean boleh membantu anda melihat di mana storan Mac anda digunakan. Imbasan dan pratonton adalah percuma; analisis AI dan pembersihan memerlukan Pro. Item pembersihan cakera yang anda sahkan dipadam secara kekal. Gunakan CLI Hugging Face untuk mengurus revisi dalam cache dan fail yang dikongsi, dan jangan masukkan kerja projek asal ke dalam pilihan pembersihan.

Apa yang boleh dicipta semula dan apa yang mesti disimpan

Semak setiap kategori secara berasingan. Jadual ini menerangkan apa yang perlu disimpan atau dipulihkan; ia tidak menandakan fail untuk dipadam secara automatik.

ItemTempat menyemakPerkara yang perlu disemak sebelum membuang
Repositori atau revisi Hubhf cache ls --revisionsSemak pilihan yang tepat. Memulihkannya mungkin memerlukan muat turun semula dan akses kepada repositori yang sama.
Blob dan snapshot yang dikongsiCache Hub yang telah disahkanGunakan pengurus cache; revisi, dan dalam sesetengah susun atur juga repositori, boleh berkongsi fail tersimpan yang sama.
Revisi detachedhf cache prune --dry-runProjek mungkin masih memerlukan revisi yang tepat walaupun cache tidak mempunyai rujukan bernama kepadanya.
Cache set data yang dijanaHF_DATASETS_CACHE / kawalan cache DatasetsBerasingan daripada muat turun Hub; penciptaan semula mungkin memerlukan masa pemprosesan dan data sumber.
Checkpoint, adapter dan sumber tersuaiLokasi projek dan sandaran andaSimpan kerja asal anda. Pastikan sandaran merangkuminya, terutamanya jika ia disimpan di bawah direktori cache.
Direktori utama Hugging Face dan data pengesahanHF_HOMEJangan padam seluruh direktori utama hanya untuk membuang entri cache model.

Ujian regresi setempat menggunakan cache sintetik yang sangat kecil. Saiz fixture itu bukan penanda aras atau anggaran penjimatan sebenar.

Soalan lazim

Bolehkah saya memadam ~/.cache/huggingface pada Mac?

Jangan anggap seluruh direktori itu boleh dibuang. Cari cache Hub yang aktif, simpan data pengesahan dan kerja asal, kemudian pratonton repositori atau revisi tertentu dengan antara muka hf cache yang dipasang.

Mengapa membuang satu revisi membebaskan ruang yang kurang daripada saiz yang dipaparkan?

Revisi boleh berkongsi fail, dan sesetengah susun atur cache turut berkongsi fail merentas repositori. Semak anggaran dalam pratonton, dan bandingkan penggunaan cakera serta ruang kosong sebelum dan selepas. Menjumlahkan saiz revisi yang dipaparkan boleh mengira fail yang sama lebih daripada sekali.

Adakah revisi detached bermakna tiada aplikasi yang menggunakannya?

Tidak. Projek boleh menetapkan revisi yang tepat walaupun tiada rujukan bernama dalam cache. Semak keperluan projek sebelum menjalankan prune.

Adakah model saya masih boleh digunakan luar talian selepas pembersihan?

Hanya fail cache yang dikekalkan dan lengkap boleh menyokong beban kerja yang memerlukannya. Uji pemuatan luar talian yang mewakili kegunaan sebenar sebelum membuang sandaran atau bergantung pada Mac tanpa sambungan.

Adakah hf cache rm akan membuang model yang saya tala halus?

Boleh, jika fail tersuai anda berada dalam entri cache yang dipilih. Simpan checkpoint, adapter dan fail yang diubah suai di luar entri yang hendak dibuang, dan sahkan sandarannya. Folder bernama cache masih boleh mengandungi satu-satunya salinan kerja penting anda.

Sumber

Lagi panduan storan model dan pembangun