huggingface-cli修改模型下载路径

• 查看下载缓存位置

huggingface-cli env

要修改 huggingface-cli 的缓存路径，你可以通过设置环境变量 HF_HUB_CACHE 来实现。这个方法非常简单且通用，因为它不仅影响 huggingface-cli，还会影响所有使用 Hugging Face Hub 的 Python 库（如 transformers、datasets、diffusers 等）。

1. 临时修改（推荐）

这是最常用的方法，因为它只在当前终端会话中有效，不会影响其他程序。

在 Linux / macOS 上：

在终端中运行以下命令，然后在这个终端里使用 huggingface-cli。

export HF_HUB_CACHE="/your/new/path"
huggingface-cli login

你也可以在同一行命令中完成：

HF_HUB_CACHE="/your/new/path" huggingface-cli login

在 Windows 上（使用 PowerShell）：

$env:HF_HUB_CACHE = "D:\huggingface_cache"
huggingface-cli login

---

2. 永久修改

如果你希望所有使用 Hugging Face 的程序都默认使用一个新的缓存路径，你可以永久设置环境变量。

在 Linux / macOS 上：

将 export HF_HUB_CACHE="/your/new/path" 这行代码添加到你的 shell 配置文件中，比如 ~/.bashrc、~/.zshrc 或 ~/.profile。

1. 打开你的配置文件：nano ~/.bashrc
2. 在文件末尾添加：export HF_HUB_CACHE="/data/huggingface_cache"
3. 保存并退出（在 nano 中按 Ctrl + O，回车，然后 Ctrl + X）。
4. 运行 source ~/.bashrc 让更改立即生效。

在 Windows 上：

1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
2. 点击“高级系统设置”，然后选择“环境变量”。
3. 在“用户变量”或“系统变量”下，点击“新建”。
4. 变量名填写 HF_HUB_CACHE，变量值填写你想要的路径，例如 D:\huggingface_cache。

---

3. 注意事项

• HF_HOME vs. HF_HUB_CACHE：Hugging Face 官方推荐使用 HF_HOME 来统一管理所有缓存。如果你设置了 HF_HOME，那么 HF_HOME 目录下的 hub 文件夹就是你的模型缓存位置。
  • 推荐做法：export HF_HOME="/your/new/path"
  • 这个设置会自动将模型缓存路径设为 /your/new/path/hub。
  • HF_HUB_CACHE 主要用于向后兼容，如果你同时设置了 HF_HOME 和 HF_HUB_CACHE，HF_HUB_CACHE 的优先级更高。
• 迁移旧缓存：如果你已经有很多下载好的模型，你可以将旧的缓存文件夹（默认在 ~/.cache/huggingface/hub）的内容，手动移动到你新设置的路径下。

通过设置这些环境变量，你可以灵活地管理 Hugging Face 模型的存储位置，尤其是在磁盘空间有限或需要将模型保存在特定位置（如网络驱动器或外部硬盘）时非常有用。