huggingface-cli download 下載的模型預設儲存在哪裡

整理 huggingface-cli download 下載模型後的預設快取位置,包括 Linux、macOS 和 Windows 下的 Hugging Face Hub 快取目錄。

如果你使用 Hugging Face 命令列工具下載模型,例如:

1
huggingface-cli download <repo-id>

下載完成後,模型檔案通常不會直接出現在目前目錄,而是會進入 Hugging Face 的預設快取目錄。

預設快取位置

huggingface-cli download 遵循 Hugging Face Hub 的快取機制。預設路徑如下:

系統 預設快取目錄
Linux / macOS ~/.cache/huggingface/hub
Windows C:\Users\用户名\.cache\huggingface\hub

在 Windows 上,如果你的使用者名稱是 knightli,預設目錄大致是:

1
C:\Users\knightli\.cache\huggingface\hub

為什麼目前目錄裡看不到模型

這是正常現象。huggingface-cli download 預設會把倉庫內容放進快取目錄,方便後續重複使用,避免每次都重新下載。

快取目錄裡通常會依照倉庫產生類似下面的結構:

1
models--组织名--模型名

例如某個模型倉庫可能會被快取成:

1
models--unsloth--gemma-4-E4B-it-GGUF

實際模型檔案通常位於該快取目錄下的 snapshots 子目錄裡。

想下載到指定目錄怎麼辦

如果你希望模型檔案出現在自己指定的位置,可以給 huggingface-cli download 加上 --local-dir

1
huggingface-cli download <repo-id> --local-dir D:\models\<model-name>

這樣更適合和 llama.cppOllamaLM Studio 等本地推理工具搭配使用,後續找檔案也更直觀。

小結

  • 預設快取目錄:~/.cache/huggingface/hub
  • Windows 預設目錄:C:\Users\用户名\.cache\huggingface\hub
  • 想放到指定目錄:使用 --local-dir
  • 如果只是找 .gguf 檔案,優先進入快取目錄下對應模型倉庫的 snapshots 子目錄查看
记录并分享
使用 Hugo 建立
主題 StackJimmy 設計