Hugging Face 缓存目录在哪里？

对于 Hugging Face Hub，有文档依据的默认缓存目录是 ~/.cache/huggingface/hub。但当前位置可以被覆盖，因此在把文件夹视为可删除之前，请检查配置和缓存本身。

默认路径和有文档依据的覆盖项

Hub 缓存在其根目录下存储已下载的模型、数据集和 Space 存储库。默认根目录为 ~/.cache/huggingface/hub。其中的存储库通常命名为 models--organization--repository，并包含数据块、快照和引用目录。

• HF_HUB_CACHE 直接设置 Hub 缓存目录，并具有优先权。
• HF_HOME 设置 Hugging Face 主目录；设置后，Hub 缓存位于 HF_HOME/hub 下。
• 各个库调用也可以指定缓存目录，因此项目可能使用不同于全局默认值的路径。

释放任何内容前先检查

使用 Hugging Face CLI 查看其缓存管理器了解的当前缓存。有文档依据的 hf cache ls 命令会列出已缓存存储库、大小和访问信息。如果移动过缓存，请将缓存管理命令与相应缓存目录选项搭配，而不要假定使用默认值。

# 显示此 shell 将使用的位置
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# 修剪前盘点已缓存存储库
hf cache ls

移除快照前，请识别使用它的项目、运行时和修订版本。缓存中可能不止包含你想到的模型文件，源代码树或本地推理工作流程可能依赖文件浏览器中并不明显的缓存修订版本。

缓存清理与长期保留

Hugging Face 缓存旨在避免不必要的下载。它不会自动成为你想长期保留的模型版本目录。如果一组已完成模型工件对工作很重要，请先决定以后需要恢复什么，并在适当位置保留独立备份。

Tensor Archive 应在作出该决定后使用：它可以保留一个相关本地系列、进行验证，并在你手动释放冗余工作副本前还原一个单独的精确副本。它不会取代 Hugging Face 自身的缓存管理，也不会告诉活动库应从何处下载模型。

安全顺序

1. 检查 HF_HUB_CACHE 或 HF_HOME 是否改变当前位置。
2. 通过 Hugging Face 工具列出缓存，并识别当前不再需要的存储库。
3. 保留或独立备份任何重要的模型版本。
4. 对于已完成的相关系列，请先分析、归档、验证并还原一个单独副本，然后再手动释放。

如果缓存位于错误磁盘，请使用正确环境变量更改 Hugging Face 缓存目录。如果问题是过时修订版本，请通过缓存管理器安全清除 Hugging Face 缓存。属于其他运行时的文件需要使用该运行时自己的存储指南。