Πώς να καθαρίσετε την cache του Hugging Face στο Mac
Ομάδα AskClean · Ενημερώθηκε 2026-11-02
Για να ανακτήσετε χώρο από την cache του Hugging Face στο Mac, βρείτε την cache που χρησιμοποιεί η εφαρμογή σας, εξετάστε τη με hf cache ls και δείτε την προεπισκόπηση για συγκεκριμένο αποθετήριο ή αναθεώρηση με hf cache rm --dry-run. Κρατήστε τα μοντέλα που χρειάζεστε εκτός σύνδεσης και τη δική σας εργασία. Μη διαγράφετε στα τυφλά κοινά blob ούτε ολόκληρο τον φάκελο HF_HOME.

Βρείτε την cache και προστατέψτε τη δική σας εργασία
Η συνήθης θέση της cache του Hub είναι το ~/.cache/huggingface/hub. Το HF_HUB_CACHE ορίζει απευθείας την cache αποθετηρίων του Hub, ενώ το HF_HOME αλλάζει ολόκληρο τον κεντρικό φάκελο του Hugging Face· όταν δεν έχει οριστεί HF_HOME, την προεπιλογή μπορεί να την επηρεάσει το XDG_CACHE_HOME, και μια εφαρμογή μπορεί επίσης να ορίσει άλλη θέση με το όρισμα cache_dir. Ελέγξτε χωριστά τις εφαρμογές με γραφικό περιβάλλον, τους πυρήνες notebook και τα έργα γραμμής εντολών, γιατί μπορεί να έχουν διαφορετικές ρυθμίσεις. Το HF_HOME μπορεί να περιέχει και στοιχεία ταυτοποίησης: μην το διαγράφετε ολόκληρο για να καθαρίσετε λήψεις μοντέλων και μη δημοσιεύετε το περιεχόμενό του σε αιτήματα υποστήριξης.
Ξεχωρίστε τις λήψεις από όσα δημιουργήσατε εσείς: fine-tuned checkpoint, adapter, αλλαγές στον tokenizer, αποτελέσματα μετατροπών, ιδιωτικά σύνολα δεδομένων, notebooks, prompts και ρυθμίσεις έργων. Ένα βασικό μοντέλο μπορεί να κατέβει ξανά, ενώ ένα τοπικό adapter ή μια διαδικασία μετατροπής ίσως υπάρχει μόνο σε αυτό το Mac. Κάντε αντίγραφο ασφαλείας και επαληθεύστε το πριν ανακτήσετε χώρο — ορισμένα εργαλεία αντιγράφων παραλείπουν φακέλους με CACHEDIR.TAG. Αν δεν ξέρετε πώς θα επαναφέρετε κάτι και θα κάνετε την εφαρμογή να λειτουργήσει ξανά, κρατήστε το προς το παρόν· ο παλιός χρόνος πρόσβασης από μόνος του δεν αποδεικνύει ότι ένα μοντέλο περισσεύει.
Εξετάστε αποθετήρια και αναθεωρήσεις πριν επιλέξετε
Κλείστε τις εφαρμογές, τις λήψεις και τις εργασίες που χρησιμοποιούν την cache. Εκτελέστε hf cache ls --no-truncate για τα πλήρη αναγνωριστικά των αποθετηρίων και μετά hf cache ls --revisions --no-truncate --show-warnings για τα πλήρη hash των αναθεωρήσεων και τυχόν προβλήματα της cache· στη δοκιμασμένη έκδοση οι λεπτομερείς προειδοποιήσεις κρύβονται από προεπιλογή. Για προσαρμοσμένη cache του Hub δώστε το ίδιο --cache-dir σε κάθε εντολή. Το μέγεθος που εμφανίζεται για μια αναθεώρηση μπορεί να ξεπερνά τον χώρο που θα ελευθερώσει η διαγραφή της, επειδή snapshots και αποθετήρια μπορεί να μοιράζονται αρχεία. Διερευνήστε τις προειδοποιήσεις για μη αναγνώσιμες ή ασυνεπείς καταχωρίσεις, ελέγξτε αν ο κώδικας ή οι ρυθμίσεις σας ορίζουν συγκεκριμένη αναθεώρηση, καταγράψτε το τρέχον μέγεθος και τον ελεύθερο χώρο και κρατήστε το αποτέλεσμα ιδιωτικό αν αποκαλύπτει εμπιστευτικά έργα.
Δείτε την προεπισκόπηση πριν επιβεβαιώσετε
Δώστε στο hf cache rm ένα πλήρες ID αποθετηρίου ή hash αναθεώρησης από την απογραφή σας και προσθέστε πρώτα --dry-run. Για αποθετήριο μοντέλου κρατήστε το πρόθεμα model/ όπως το δείχνει το CLI· ένα όνομα φακέλου που αρχίζει με models-- δεν είναι το ίδιο αναγνωριστικό. Για μία αναθεώρηση χρησιμοποιήστε το πλήρες hash και ελέγξτε σε ποιο αποθετήριο ανήκει. Η προεπισκόπηση συνοψίζει τους στόχους και τον εκτιμώμενο χώρο που θα ελευθερωθεί· δεν απαριθμεί κάθε αρχείο. Αν επιλέξετε αποθετήριο, καλύπτονται όλες οι αποθηκευμένες αναθεωρήσεις του, οπότε για μία μόνο επιλέξτε την αναθεώρηση.
Αφού ελέγξετε το εύρος, επαναλάβετε την ίδια εντολή χωρίς --dry-run, με τον ίδιο στόχο και τον ίδιο φάκελο cache, και αφήστε ενεργό το ερώτημα επιβεβαίωσης. Αν η λίστα αλλάξει απροσδόκητα ή η προεπισκόπηση αποτύχει, σταματήστε και βρείτε την αιτία — ίσως κάποια εφαρμογή ξεκίνησε ξανά ή κατέβασε δεδομένα. Αφήστε τα κοινά blob και τις αναφορές των snapshots στον διαχειριστή cache του Hugging Face· η διαγραφή μεμονωμένων αρχείων στο Finder μπορεί να χαλάσει άλλες αναθεωρήσεις. Η αφαίρεση από την cache διαγράφει τα αρχεία απευθείας, χωρίς Κάδο: για να επαναφέρετε μια αναθεώρηση χρειάζεστε αντίγραφο ασφαλείας ή νέα λήψη. Κρατήστε αντίγραφο μέχρι να περάσουν οι έλεγχοι, ειδικά για μοντέλα ιδιωτικά, με περιορισμένη πρόσβαση, αποσυρμένα, τροποποιημένα τοπικά ή απαραίτητα εκτός σύνδεσης.
Ελέγξτε το prune και τις υπόλοιπες cache χωριστά
Στο CLI 2.0.0 που δοκιμάσαμε, το hf cache prune --dry-run εμφανίζει detached αναθεωρήσεις και ημιτελείς λήψεις. Μια detached αναθεώρηση δεν έχει ονομασμένη αναφορά στην cache, αλλά ένα έργο μπορεί να ζητά ακόμη ακριβώς αυτήν· ελέγξτε τα έργα σας πριν εγκρίνετε την αφαίρεσή της. Στον πρώτο καθαρισμό, μία συγκεκριμένη αφαίρεση αξιολογείται ευκολότερα από ένα ευρύ σκούπισμα. Αν αργότερα χρησιμοποιήσετε prune, εφαρμόστε τον ίδιο έλεγχο σε όλους τους υποψηφίους και σταματήστε πρώτα τις ενεργές λήψεις, ώστε ένα ημιτελές αρχείο που χρησιμοποιεί άλλη εργασία να μη θεωρηθεί εγκαταλελειμμένο.
Τα επεξεργασμένα δεδομένα του Hugging Face Datasets στο HF_DATASETS_CACHE είναι ξεχωριστά από τις λήψεις του Hub· η αφαίρεση λήψεων του Hub δεν τα αγγίζει απαραίτητα. Τα αρχεία που κατεβάσατε με ρητό local_dir βρίσκονται σε φάκελο που επιλέξατε εσείς ή η εφαρμογή: χειριστείτε τον χωριστά και κρατήστε τυχόν δικά σας scripts ή αλλαγές, γιατί μια νέα λήψη δεν θα τις επαναφέρει. Και ο χώρος των μεταφορών Xet είναι χωριστός. Αν η χρήση χώρου παραμένει υψηλή, ελέγξτε κάθε κατηγορία χωριστά αντί να διαγράψετε ολόκληρο το HF_HOME.
Ελέγξτε ότι τα μοντέλα που κρατήσατε λειτουργούν
Επαναλάβετε την απογραφή και τις μετρήσεις, φορτώστε ένα μοντέλο και μια αναθεώρηση που θέλατε να κρατήσετε και εκτελέστε μια μικρή εργασία με γνωστό αποτέλεσμα· η απλή εισαγωγή μιας βιβλιοθήκης Python δεν ελέγχει τα αρχεία του μοντέλου. Αν χρειάζεστε χρήση εκτός σύνδεσης, δοκιμάστε με το δίκτυο αποσυνδεδεμένο. Αν η επόμενη εκτέλεση κατεβάσει ξανά το ίδιο μοντέλο, ο καθαρισμός αφαίρεσε δεδομένα που χρειάζεται η εργασία· αναθεωρήστε την επιλογή, τη χωρητικότητα ή τη θέση της cache αντί να διαγράφετε και να κατεβάζετε ξανά. Αν κάποιος έλεγχος αποτύχει, σταματήστε τον καθαρισμό, καταγράψτε μοντέλο, αναθεώρηση, διαδρομή cache και σφάλμα και λύστε το πρόβλημα πριν αφαιρέσετε άλλη καταχώριση.
Αν τα μοντέλα που χρειάζεστε τακτικά ξεπερνούν τη χωρητικότητα του Mac, ένας εξωτερικός δίσκος μπορεί να βοηθήσει. Ελέγξτε τον ελεύθερο χώρο, τα δικαιώματα και την υποστήριξη συμβολικών συνδέσμων, που συνδέουν τα snapshots με τα κοινά blob, και κατά την αντιγραφή διατηρήστε τους συνδέσμους μαζί με τα αρχεία στα οποία δείχνουν. Ρυθμίστε κάθε εφαρμογή να χρησιμοποιεί τη νέα θέση και δοκιμάστε εκεί τα απαραίτητα μοντέλα πριν αφαιρέσετε το πρωτότυπο. Ο δίσκος πρέπει να είναι συνδεδεμένος όποτε τον χρειάζονται αυτές οι εφαρμογές.
Πώς ελέγξαμε αυτές τις εντολές
Στις 2026-09-29 δοκιμάσαμε τις εντολές με huggingface_hub 2.0.0 σε προσωρινή, συνθετική cache τύπου Hub, χωρίς σύνδεση: η απογραφή αναθεωρήσεων πέτυχε, τα dry run των rm και prune δεν άλλαξαν τίποτα και η αφαίρεση της παλιάς αναθεώρησης κράτησε την τρέχουσα και τα κοινά δεδομένα, ενώ διέγραψε το αποκλειστικό blob της παλιάς. Ένας δεύτερος έλεγχος επιβεβαίωσε ότι το --show-warnings εμφανίζει μια σκόπιμα αλλοιωμένη καταχώριση και ότι το --no-truncate διατηρεί το πλήρες ID. Δεν δοκιμάστηκαν πραγματικές λήψεις μοντέλων, εκτέλεση μοντέλων, cache χρηστών, μεταφορά σε άλλο δίσκο ή κοινά blob μεταξύ αποθετηρίων, γι' αυτό ο οδηγός δεν υπόσχεται συγκεκριμένη εξοικονόμηση χώρου. Πριν ξεκινήσετε, εκτελέστε hf cache --help· αν η έκδοσή σας προσφέρει διαφορετικές εντολές ή επιλογές, ακολουθήστε την τεκμηρίωσή της.
Τι δημιουργείται ξανά και τι πρέπει να κρατήσετε
Ελέγξτε κάθε κατηγορία χωριστά. Ο πίνακας δείχνει τι πρέπει να διατηρήσετε ή να επαναφέρετε· δεν επισημαίνει αρχεία για αυτόματη διαγραφή ούτε υπόσχεται συγκεκριμένο ελεύθερο χώρο.
| Στοιχείο | Πού ελέγχεται | Τι ελέγχετε πριν από την αφαίρεση |
|---|---|---|
| Αποθετήριο ή αναθεώρηση του Hub | hf cache ls --revisions | Ελέγξτε την ακριβή επιλογή. Η επαναφορά μπορεί να απαιτεί νέα λήψη και πρόσβαση στο ίδιο αποθετήριο. |
| Κοινά blob και snapshots | Επιβεβαιωμένη cache του Hub | Χρησιμοποιήστε τον διαχειριστή cache· οι αναθεωρήσεις και, σε ορισμένες δομές, τα αποθετήρια μπορεί να μοιράζονται τα ίδια αρχεία. |
| Detached αναθεωρήσεις | hf cache prune --dry-run | Ένα έργο μπορεί να χρειάζεται ακριβώς αυτή την αναθεώρηση, ακόμη κι αν η cache δεν έχει ονομασμένη αναφορά σε αυτήν. |
| Cache παραγόμενων συνόλων δεδομένων | HF_DATASETS_CACHE | Ξεχωριστή από τις λήψεις του Hub· η αναδημιουργία μπορεί να απαιτεί χρόνο επεξεργασίας και τα αρχικά δεδομένα. |
| Δικά σας checkpoint, adapter και κώδικας | Φάκελοι έργων και αντιγράφων ασφαλείας | Κρατήστε την πρωτότυπη εργασία σας και επαληθεύστε ότι τα αντίγραφα ασφαλείας την περιλαμβάνουν, ειδικά αν βρίσκεται μέσα σε φάκελο cache. |
| Κεντρικός φάκελος Hugging Face και στοιχεία ταυτοποίησης | HF_HOME | Μη διαγράψετε ολόκληρο τον φάκελο για να αφαιρέσετε καταχωρίσεις μοντέλων από την cache. |
Ο τοπικός έλεγχος χρησιμοποίησε μια μικροσκοπική συνθετική cache· το μέγεθός της δεν είναι μέτρο σύγκρισης ούτε εκτίμηση πραγματικής εξοικονόμησης χώρου.
Συχνές ερωτήσεις
Μπορώ να διαγράψω το ~/.cache/huggingface στο Mac;
Μην αντιμετωπίζετε ολόκληρο τον φάκελο ως αναλώσιμο. Βρείτε την ενεργή cache του Hub, προστατέψτε τα στοιχεία ταυτοποίησης και την πρωτότυπη εργασία σας και δείτε την προεπισκόπηση για συγκεκριμένα αποθετήρια ή αναθεωρήσεις με την εγκατεστημένη έκδοση του hf cache.
Μια detached αναθεώρηση σημαίνει ότι καμία εφαρμογή δεν τη χρησιμοποιεί;
Όχι. Ένα έργο μπορεί να ορίζει ακριβώς αυτή την αναθεώρηση, ακόμη κι αν δεν υπάρχει ονομασμένη αναφορά στην cache. Ελέγξτε τις απαιτήσεις του έργου πριν από το prune.
Μπορεί το hf cache rm να διαγράψει το fine-tuned μοντέλο μου;
Ναι, αν τα δικά σας αρχεία βρίσκονται μέσα στην καταχώριση που επιλέξατε. Κρατήστε checkpoint, adapter και τροποποιημένα αρχεία έξω από τις καταχωρίσεις που σκοπεύετε να αφαιρέσετε και επαληθεύστε τα αντίγραφά τους. Ένας φάκελος με το όνομα cache μπορεί να περιέχει το μοναδικό αντίγραφο σημαντικής δουλειάς.
Πηγές