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 等本地推理工具配合使用，后续找文件也更直观。