Näin tyhjennät Hugging Face -välimuistin Macissa
AskClean-tiimi · Päivitetty 2026-11-02
Kun haluat vapauttaa Hugging Face -välimuistin tilaa Macissa, selvitä ensin sovelluksesi käyttämä välimuisti, tarkista se komennolla hf cache ls ja esikatsele yksittäisen repositorion tai revision poisto komennolla hf cache rm --dry-run. Säilytä offline-käytössä tarvittavat mallit ja oma työsi. Älä poista jaettuja blob-tiedostoja tai koko HF_HOME-hakemistoa sokkona.

Paikanna välimuisti ja suojaa oma työ
Hub-välimuisti on tavallisesti polussa ~/.cache/huggingface/hub. HF_HUB_CACHE valitsee suoraan Hub-repositorioiden välimuistin, HF_HOME muuttaa laajemman Hugging Face -kotihakemiston, ja jos HF_HOME ei ole asetettu, XDG_CACHE_HOME voi vaikuttaa oletukseen. Sovelluksen cache_dir-argumentti voi valita vielä toisen polun. Tarkista graafiset sovellukset, notebook-ytimet ja komentoriviprojektit erikseen. HF_HOME voi sisältää myös tunnistautumistietoja: älä poista koko hakemistoa mallilatausten siivoamiseksi, äläkä liitä sen sisältöä tukipyyntöihin.
Erota lataukset omasta työstäsi: hienosäädetyt checkpointit, adapterit, tokenizer-muutokset, muunnostulokset, yksityiset tietoaineistot, notebookit ja projektin asetukset eivät välttämättä ole ladattavissa uudelleen. Varmuuskopioi ja tarkista ne ennen siivousta – jotkin varmuuskopiotyökalut ohittavat CACHEDIR.TAG-merkityt välimuistit. Jos et tiedä, miten palauttaisit kohteen, säilytä se toistaiseksi. Vanha käyttöajankohta ei yksin tee mallista tarpeetonta.
Näytä täydet tunnisteet ja varoitukset
Pysäytä välimuistia käyttävät sovellukset, lataukset ja työt. Aja hf cache ls --no-truncate ja sitten hf cache ls --revisions --no-truncate --show-warnings. Testattu versio piilottaa yksityiskohtaiset varoitukset oletuksena. Käytä mukautetulle sijainnille jokaisessa komennossa samaa --cache-dir-arvoa. Tutki luku- ja rakenneongelmat ennen poistoa, tarkista, tarvitseeko jokin sovellus tai projekti yhä valitsemaasi repositoriota tai koodiin kiinnitettyä revisiota, ja kirjaa käytetty ja vapaa levytila. Älä julkaise yksityisiä repositorioluetteloita.
Tarkista laajuus ennen vahvistusta
hf cache rm tarvitsee CLI:n näyttämän täydellisen tunnisteen. Säilytä mallirepositorion model/-etuliite; kansion nimi, joka alkaa merkkijonolla models--, ei kelpaa tunnisteeksi. Käytä yksittäiselle revisiolle täyttä hash-arvoa ja tarkista, mihin repositorioon se kuuluu. Aloita --dry-run-valitsimella. Tulos on kohteiden ja arvioidun vapautuvan tilan yhteenveto, ei tiedostokohtainen luettelo. Repositoriokohde kattaa kaikki sen välimuistissa olevat revisiot.
Kun laajuus on tarkistettu, aja sama komento samalla kohteella ja polulla ilman --dry-run-valitsinta ja jätä vahvistuskysymys käyttöön. Jos valinta muuttuu tai esikatselu epäonnistuu, keskeytä poisto ja selvitä syy. Välimuistin poisto poistaa tiedostot suoraan; ne eivät siirry roskakoriin, joten palauttaminen vaatii varmuuskopion tai uuden latauksen ja pääsyn repositorioon. Säilytä varmuuskopio, kunnes tarkistukset menevät läpi, varsinkin yksityisistä, rajatun pääsyn, julkaisusta poistetuista, paikallisesti muokatuista tai offline-käytössä tarvittavista malleista. Snapshotit – ja joissakin välimuistirakenteissa myös repositoriot – jakavat blob-tiedostoja: jätä viittaukset välimuistinhallinnalle äläkä laske näytettyjä kokoja suoraan yhteen.
Erota prune ja muut välimuistit
Testatussa versiossa 2.0.0 hf cache prune --dry-run näyttää detached-revisiot ja keskeneräiset lataukset. Detached-revisiolla ei ole välimuistissa nimettyä viittausta, mutta projekti voi silti pyytää juuri sitä revisiota. Tarkista jokainen kohde ja pysäytä aktiiviset lataukset. Aloita yhdestä selvästi rajatusta kohteesta.
Hugging Face Datasetsin tuottamat tiedot (HF_DATASETS_CACHE) ovat eri asia kuin Hub-lataukset. Tarkista Xet-siirtotiedot ja local_dir-latauskohteet erikseen ja säilytä paikalliset muutokset. Koko HF_HOME-hakemiston poistaminen ei korvaa tätä tarkistusta.
Varmista, että säilytetyt mallit toimivat
Toista inventaario ja mittaukset, avaa säilyttämäsi malli ja revisio ja aja pieni tehtävä, jonka tuloksen tiedät. Pelkkä Python-kirjaston tuonti ei tarkista mallitiedostoja. Jos tarvitset offline-käyttöä, testaa verkkoyhteys katkaistuna. Jos tarkistus epäonnistuu, keskeytä siivous ja selvitä ympäristö, polut, tiedostot, oikeudet ja vapaa tila ennen palauttamista. Jos tarvittava malli latautuu toistuvasti uudelleen, arvioi valinta, tallennuskapasiteetti tai välimuistin sijainti uudelleen.
Jos siirrät välimuistin ulkoiselle levylle, tarkista vapaa tila, oikeudet ja symbolisten linkkien tuki. Kopioi linkit kohteineen, määritä jokainen sovellus käyttämään uutta sijaintia ja testaa sen mallit ennen alkuperäisen poistamista. Levyn on oltava kytkettynä aina, kun sovellukset tarvitsevat sitä.
Mitä on tarkistettu
Testasimme 29.9.2026 tilapäisiä synteettisiä välimuisteja offline-tilassa paketilla huggingface_hub 2.0.0: luettelot, täydet tunnisteet, varoitukset ja dry-run-esikatselut. Esikatselut eivät muuttaneet tiedostoja, ja vanhan revision poisto säilytti nykyisen revision ja yhteiset tiedot. Oikeaa malliajoa, käyttäjän välimuistia, repositorioiden yhteisiä blob-tiedostoja tai levysiirtoa ei testattu, eikä tiettyä tilansäästöä luvata. Tarkista oma versiosi komennolla hf cache --help.
Tarkista ennen poistamista
Tarkista jokainen luokka erikseen. Taulukko kertoo, mitä on säilytettävä tai miten kohteen voi palauttaa; se ei merkitse tiedostoja automaattisesti poistettaviksi eikä lupaa tiettyä määrää vapaata tilaa.
| Kohde | Mistä tarkistaa | Seuraukset ja ehdot |
|---|---|---|
| Hub-repositorio tai -revisio | hf cache ls --revisions | Varmista tarkka valinta. Palauttaminen voi vaatia uuden latauksen ja pääsyn samaan repositorioon. |
| Jaetut blob-tiedostot ja snapshotit | blob / snapshot | Anna välimuistinhallinnan käsitellä viittaukset; älä laske kokoja suoraan yhteen. |
| Detached-revisio | hf cache prune --dry-run | Projekti voi yhä tarvita täsmälleen tätä revisiota. |
| Tuotetut tietoaineistot | HF_DATASETS_CACHE | Erillään Hub-latauksista; uudelleenluonti vaatii lähdetiedot ja käsittelyaikaa. |
| Omat mallit ja työ | checkpoint / adapter | Säilytä alkuperäiset ja tarkista varmuuskopioiden todellinen sisältö. |
| Hugging Facen kotihakemisto | HF_HOME | Voi sisältää tunnistautumistietoja; älä poista koko hakemistoa. |
UKK
Voinko poistaa ~/.cache/huggingface-kansion Macista?
Älä pidä koko hakemistoa poistettavana. Paikanna aktiivinen Hub-välimuisti, säilytä tunnistautumistiedot ja oma työsi ja esikatsele sitten yksittäiset repositoriot tai revisiot asennetulla hf cache -komennolla.
Onko detached-revisio käyttämätön?
Ei välttämättä. Projekti voi määrittää tarkan revision, vaikka välimuistissa ei ole sille nimettyä viittausta. Tarkista riippuvuudet ensin.
Voiko hf cache rm poistaa hienosäätämäni mallin?
Voi, jos mallin tiedostot ovat valitun kohteen sisällä. Säilytä checkpointit, adapterit ja muokatut tiedostot poistettavien kohteiden ulkopuolella ja tarkista niiden varmuuskopio. Cache-niminen kansio voi silti sisältää tärkeän työsi ainoan kopion.
Lähteet