Kontrollér og ryd Hugging Face-cachen på Mac

Find placeringen, og beskyt arbejdet

Den normale placering er ~/.cache/huggingface/hub. HF_HUB_CACHE vælger repositorycachen; HF_HOME omfatter mere. Uden HF_HOME kan XDG_CACHE_HOME påvirke standarden, mens cache_dir kan vælge en anden sti. Kontrollér grafiske apps, terminal og notebook hver for sig. HF_HOME kan indeholde loginoplysninger: slet ikke det hele, og offentliggør ikke indholdet.

Egne checkpoints, adaptere, tokenizerændringer, konverteringer, private data og projektindstillinger kan måske ikke downloades igen. Kontrollér sikkerhedskopien; nogle værktøjer springer cacher med CACHEDIR.TAG over. Behold indhold uden en kendt gendannelsesmetode. En gammel adgangsdato betyder ikke, at modellen er overflødig.

Vis fulde ID’er og advarsler

Stop apps, downloads og opgaver, som bruger cachen. Kør hf cache ls --no-truncate og derefter hf cache ls --revisions --no-truncate --show-warnings. Den testede version skjuler detaljerede advarsler som standard. Brug samme --cache-dir hver gang til en brugerdefineret placering. Undersøg læse- og strukturfejl, notér brugt og ledig plads, og del ikke private repositorylister.

Kontrollér omfanget før bekræftelse

hf cache rm kræver det fulde ID fra CLI. Behold model/ for et modelrepository; et mappenavn med models-- er ikke en erstatning. Brug den fulde hash til én revision, og kontrollér dens repository. Start med --dry-run. Resultatet opsummerer mål og forventet plads, ikke hver enkelt fil. Et repositorymål omfatter alle dets cachede revisioner.

Fjern efter kontrollen kun --dry-run, og behold mål, sti og bekræftelsesspørgsmål. Hvis valget ændres eller forhåndsvisningen fejler, så stop sletningen og find årsagen. Filer slettes direkte uden Papirkurv; gendannelse kræver en sikkerhedskopi eller ny downloadadgang. Snapshots og i visse formater repositories deler blobs. Lad cacheværktøjet håndtere referencerne, og læg ikke viste størrelser ukritisk sammen.

Skeln mellem prune og andre cacher

I den testede version 2.0.0 viser hf cache prune --dry-run detached-revisioner og ufuldstændige downloads. Et projekt kan fastholde en bestemt revision selv uden en navngivet reference. Kontrollér hvert mål, og stop aktive downloads. Begynd med ét tydeligt afgrænset element.

Genererede data i HF_DATASETS_CACHE adskiller sig fra Hub-downloads. Undersøg Xet-overførsler og local_dir-output separat, og behold lokale ændringer. Sletning af hele HF_HOME erstatter ikke denne gennemgang.

Indlæs faktisk de bevarede modeller

Gentag målingerne, indlæs nødvendige modeller og revisioner, og kør en lille opgave med kendt resultat. En vellykket Python-import er ikke nok. Test offlinebrug med netværket afbrudt. Stop ved fejl, og kontrollér miljø, stier, filer, adgang og plads før gendannelse. Gentagen download af en nødvendig model kræver et andet valg eller mere kapacitet.

Ved flytning til ekstern disk skal du kontrollere plads, rettigheder og symbolske links. Kopiér links og deres mål, konfigurér hver app, og test modellerne, før originalen fjernes. Disken skal være tilsluttet under brug.

Hvad der blev verificeret

Den 2026-09-29 blev midlertidige syntetiske cacher testet offline med huggingface_hub 2.0.0: lister, fulde ID’er, advarsler og dry-run. Forhåndsvisninger ændrede ingen filer; fjernelse af en gammel revision bevarede den aktuelle og delte data. Virkelig inferens, brugercacher, delte blobs mellem repositories og diskflytning blev ikke testet. Ingen fast pladsgevinst garanteres. Kontrollér din version med hf cache --help.

Kontrollér før du sletter

Kontrollér den faktiske placering, formålet og muligheden for gendannelse. Tabellen er ikke en automatisk sletteliste og lover ikke en bestemt mængde ledig plads.

FAQ