Så rensar du Hugging Face-cachen på Mac
AskClean-teamet · Uppdaterad 2026-11-02
För att frigöra utrymme i Hugging Face-cachen på en Mac tar du först reda på vilken cache appen faktiskt använder, granskar den med hf cache ls och förhandsgranskar ett bestämt repository eller en revision med hf cache rm --dry-run. Behåll modeller som behövs offline och ditt eget arbete, och radera aldrig delade blobbar eller hela HF_HOME-mappen på måfå.

Hitta rätt cache och skydda ditt eget arbete
Hub-cachen ligger normalt i ~/.cache/huggingface/hub. HF_HUB_CACHE pekar ut Hub-cachen direkt, medan HF_HOME flyttar hela Hugging Face-hemkatalogen; om HF_HOME inte är satt kan XDG_CACHE_HOME påverka standardplatsen, och ett cache_dir-argument i en app kan välja en helt annan plats. Kontrollera grafiska appar, notebook-kärnor och kommandoradsprojekt var för sig. HF_HOME kan också innehålla autentiseringsuppgifter, så radera inte hela katalogen för att bli av med modellhämtningar, och dela bara relevanta inställningar utan känsliga värden om du ber om hjälp.
Skilj hämtningar från det du själv har skapat: finjusterade checkpoints, adaptrar, tokenizer-ändringar, konverteringar, privata dataset, notebooks och projektinställningar går inte att ladda ner igen. Säkerhetskopiera och kontrollera det arbetet innan du rensar, eftersom vissa verktyg för säkerhetskopiering hoppar över kataloger märkta med CACHEDIR.TAG. Behåll allt du inte vet hur du återställer; en gammal åtkomsttid bevisar inte att en modell är överflödig.
Granska repositories och revisioner innan du väljer
Börja med hf cache ls --no-truncate för att se fullständiga repository-ID:n och kör sedan hf cache ls --revisions --no-truncate --show-warnings för att se hela revisionshashar och eventuella problem i cachen. I den testade versionen döljs detaljerade varningar som standard. Har du en egen Hub-cache anger du samma --cache-dir i alla kommandon. Undersök varningar om oläsbara eller inkonsekventa poster innan du tar bort något, och håll listor över privata repositories för dig själv.
- Stäng appar och jobb som använder cachen.
- Kör hf cache ls --no-truncate och sedan hf cache ls --revisions --no-truncate --show-warnings mot den kontrollerade cachesökvägen.
- Kontrollera om någon app eller något projekt fortfarande behöver det valda repositoryt och den valda revisionen.
- Anteckna mappens storlek och ledigt diskutrymme innan du ändrar något.
Förhandsgranska borttagningen innan du bekräftar
Ange ett fullständigt repository-ID eller en revisionshash från din inventering till hf cache rm och lägg först till --dry-run. För ett modellrepository behåller du prefixet model/ som CLI:t visar; ett mappnamn som börjar med models-- är inte samma ID. För en enskild revision använder du hela hashen och kontrollerar vilket repository den hör till. Förhandsgranskningen sammanfattar mål och uppskattad utrymmesvinst men listar inte varje fil, och ett repository som mål omfattar alla dess cachade revisioner.
När omfattningen stämmer kör du samma kommando utan --dry-run, med samma mål och cachekatalog, och låter bekräftelsefrågan vara kvar. Ändras listan oväntat eller misslyckas förhandsgranskningen ska du stoppa och undersöka orsaken. Rensningen raderar filerna direkt – de hamnar inte i papperskorgen – så återställning kräver en fungerande säkerhetskopia eller en ny nedladdning. Snapshots, och i vissa cachelayouter även repositories, delar blobbar: låt Hugging Faces cachehanterare sköta referenserna, radera inte enskilda filer i Finder och summera inte visade storlekar rakt av.
Granska prune-kandidater och andra cachetyper separat
I den testade versionen 2.0.0 visar hf cache prune --dry-run frikopplade (detached) revisioner och ofullständiga nedladdningar. En frikopplad revision saknar namngiven referens i cachen, men ditt projekt kan ändå begära exakt den revisionen. Granska varje kandidat, stoppa aktiva nedladdningar och börja hellre med en enda tydligt vald borttagning än med en bred rensning.
Bearbetade dataset i HF_DATASETS_CACHE är något annat än Hub-nedladdningar, och filer som hämtats med local_dir hamnar i en mapp som du eller appen har valt. Granska dem, liksom Xet-överföringscachen, separat och bevara lokala ändringar – en ny nedladdning återställer inte dina redigeringar. Att radera hela HF_HOME ersätter inte den här kontrollen.
Kontrollera att kvarvarande modeller fungerar
Upprepa inventeringen och mätningen, ladda en modell och revision som du ville behålla och kör en liten uppgift med känt resultat – att importera ett Python-bibliotek kontrollerar inte modellfilerna. Behöver du offlineåtkomst testar du med nätverket frånkopplat. Misslyckas en kontroll pausar du rensningen, kontrollerar miljö, sökväg, filer, åtkomst och ledigt utrymme och återställer från säkerhetskopia eller laddar ner revisionen igen innan du tar bort något mer. Laddas samma modell ner igen vid nästa körning behöver du se över urvalet eller kapaciteten i stället för att radera och hämta om och om igen.
Räcker inte Macens lagring kan en extern disk hjälpa. Kontrollera ledigt utrymme, behörigheter och stöd för symboliska länkar, som kopplar snapshots till delade blobbar, och bevara länkarna och filerna de pekar på när du kopierar. Konfigurera varje app att använda den nya platsen och testa modellerna där innan du tar bort originalet. Disken måste vara ansluten när apparna behöver den.
Så kontrollerade vi kommandona
Den 2026-09-29 testade vi offline med huggingface_hub 2.0.0 på tillfälliga, syntetiska cacher: listning av revisioner, fullständiga ID:n, varningar och torrkörningar med rm och prune. Förhandsgranskningarna ändrade inga filer, och när den äldre revisionen togs bort fanns den aktuella revisionen och dess delade data kvar. Vi har inte testat riktiga modellnedladdningar, inferens, användares cacher, flytt till en annan disk eller blobbar som delas mellan repositories, och resultatet säger inget om hur många gigabyte din Mac frigör. Kör hf cache --help i din miljö och följ dokumentationen om din version skiljer sig.
AskClean kan visa var lagringen används på din Mac. Skanning och förhandsvisning är gratis, medan AI-analys och rensning kräver Pro. Diskrensningen raderar de objekt du bekräftar permanent, så hantera cachade revisioner och delade filer med Hugging Faces CLI och håll ditt eget projektarbete utanför urvalet.
Vad som kan återskapas och vad som måste sparas
Kontrollera varje kategori för sig. Tabellen visar vad du behöver bevara eller kunna återställa; den markerar inga filer för automatisk radering.
| Objekt | Var du kontrollerar | Kontrollera före borttagning |
|---|---|---|
| Repository eller revision i Hub-cachen | hf cache ls --revisions | Kontrollera exakt urval. Återställning kan kräva en ny nedladdning och åtkomst till samma repository. |
| Delade blobbar och snapshots | Den kontrollerade Hub-cachen | Använd cachehanteraren; revisioner och i vissa layouter även repositories kan dela samma lagrade filer. |
| Frikopplade revisioner | hf cache prune --dry-run | Ett projekt kan fortfarande behöva exakt den revisionen även om cachen saknar namngiven referens till den. |
| Cache för genererade dataset | HF_DATASETS_CACHE / Datasets-cacheinställningar | Skild från Hub-nedladdningar; att återskapa den kan kräva bearbetningstid och källdata. |
| Egna checkpoints, adaptrar och källfiler | Dina projektmappar och platser för säkerhetskopior | Behåll originalarbetet. Kontrollera att säkerhetskopiorna innehåller det, särskilt om det ligger i en cachekatalog. |
| Hugging Face-hemkatalog och autentisering | HF_HOME | Radera inte hela hemkatalogen för att ta bort modellcache. |
Den lokala kontrollen gjordes med en mycket liten syntetisk cache. Dess storlek är varken ett riktmärke eller en uppskattning av hur mycket du kan spara i verkligheten.
Vanliga frågor
Kan jag radera ~/.cache/huggingface på min Mac?
Behandla inte hela katalogen som något som kan kastas. Hitta den aktiva Hub-cachen, bevara autentiseringsuppgifter och eget arbete och förhandsgranska sedan bestämda repositories eller revisioner med det installerade hf cache-kommandot.
Varför frigör en borttagen revision mindre än sin visade storlek?
Revisioner kan dela filer, och i vissa cachelayouter delas de även mellan repositories. Kontrollera förhandsgranskningens uppskattning och jämför diskanvändning och ledigt utrymme före och efter. Lägger du ihop visade storlekar kan samma filer räknas flera gånger.
Är en frikopplad revision oanvänd?
Inte nödvändigtvis. Ett projekt kan låsa en exakt revision utan att det finns en namngiven referens i cachen. Kontrollera projektets krav innan du kör prune.
Fungerar mina modeller offline efter rensningen?
Bara kvarvarande, kompletta cachefiler kan användas av de arbetsflöden som behöver dem. Testa att ladda en representativ modell offline innan du tar bort din säkerhetskopia eller använder datorn utan nätverk.
Kan hf cache rm radera min finjusterade modell?
Ja, om dina egna filer ligger i den valda cacheposten. Håll checkpoints, adaptrar och ändrade filer utanför poster som du tänker ta bort och kontrollera säkerhetskopiorna. En mapp som heter cache kan ändå innehålla den enda kopian av viktigt arbete.
Källor