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 设计