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

Fri, 17 Apr 2026 14:48:04 +0800

如果你使用 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.cpp、Ollama、LM Studio 等本地推理工具搭配使用，後續找檔案也更直觀。