Hugging Face 快取目錄在哪裡？

對於 Hugging Face Hub，有文件依據的預設快取目錄是 ~/.cache/huggingface/hub。但目前位置可以被覆寫，因此在把資料夾視為可刪除之前，請檢查設定和快取本身。

預設路徑和有文件依據的覆寫項

Hub 快取在其根目錄下儲存已下載的模型、資料集和 Space 儲存庫。預設根目錄為 ~/.cache/huggingface/hub。其中的儲存庫通常命名為 models--organization--repository，並包含Blob、快照和引用目錄。

• HF_HUB_CACHE 直接設定 Hub 快取目錄，並具有優先權。
• HF_HOME 設定 Hugging Face 主目錄；設定後，Hub 快取位於 HF_HOME/hub 下。
• 各個庫呼叫也可以指定快取目錄，因此專案可能使用不同於全域性預設值的路徑。

釋放任何內容前先檢查

使用 Hugging Face CLI 檢視其快取管理器瞭解的目前快取。有文件依據的 hf cache ls 命令會列出已快取儲存庫、大小和存取資訊。如果移動過快取，請將快取管理命令與相應快取目錄選項搭配，而不要假定使用預設值。

# 顯示此 shell 將使用的位置
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# 修剪前盤點已快取儲存庫
hf cache ls

移除快照前，請識別使用它的專案、執行環境和修訂版本。快取中可能不止包含你想到的模型檔案，原始碼樹或本機推理工作流程可能依賴檔案瀏覽器中並不明顯的快取修訂版本。

快取清理與長期保留

Hugging Face 快取旨在避免不必要的下載。它不會自動成為你想長期保留的模型版本目錄。如果一組已完成模型產出物對工作很重要，請先決定以後需要復原什麼，並在適當位置保留獨立備份。

Tensor Archive 應在作出該決定後使用：它可以保留一個相關本機系列、進行驗證，並在你手動釋放冗餘工作副本前還原一個單獨的精確副本。它不會取代 Hugging Face 自身的快取管理，也不會告訴活動庫應從何處下載模型。

安全順序

1. 檢查 HF_HUB_CACHE 或 HF_HOME 是否改變目前位置。
2. 透過 Hugging Face 工具列出快取，並識別目前不再需要的儲存庫。
3. 保留或獨立備份任何重要的模型版本。
4. 對於已完成的相關系列，請先分析、封存、驗證並還原一個單獨副本，然後再手動釋放。

如果快取位於錯誤磁碟，請使用正確環境變數更改 Hugging Face 快取目錄。如果問題是過時修訂版本，請透過快取管理器安全清除 Hugging Face 快取。屬於其他執行環境的檔案需要使用該執行環境自己的儲存指南。