删除Hugging Face缓存后出现LocalEntryNotFoundError，如何恢复缓存结构？

异常信息 #

上述异常是导致以下异常的直接原因：

Traceback (most recent call last):
File "/home/pangchongwen/anaconda3/envs/chatglm3/bin/huggingface-cli", line 8, in <module>
sys.exit(main())
File "/home/pangchongwen/anaconda3/envs/chatglm3/lib/python3.10/site-packages/huggingface_hub/commands/huggingface_cli.py", line 49, in main
service.run()
File "/home/pangchongwen/anaconda3/envs/chatglm3/lib/python3.10/site-packages/huggingface_hub/commands/download.py", line 160, in run
print(self._download())  # Print path to downloaded files
File "/home/pangchongwen/anaconda3/envs/chatglm3/lib/python3.10/site-packages/huggingface_hub/commands/download.py", line 201, in _download
return snapshot_download(
File "/home/pangchongwen/anaconda3/envs/chatglm3/lib/python3.10/site-packages/huggingface_hub/utils/_validators.py", line 118, in _inner_fn
return fn(*args, **kwargs)
File "/home/pangchongwen/anaconda3/envs/chatglm3/lib/python3.10/site-packages/huggingface_hub/_snapshot_download.py", line 251, in snapshot_download
raise LocalEntryNotFoundError(
huggingface_hub.utils._errors.LocalEntryNotFoundError: An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision on the local disk. Please check your internet connection and try again.

问题描述 #

删除.cache文件夹中的Hugging Face缓存后出现上述错误，已排除网络问题，需恢复Hugging Face的缓存目录结构。

解决步骤 #

• 重新执行下载命令：直接运行之前使用的huggingface-cli download命令，或者在代码中调用snapshot_download等相关下载方法，Hugging Face Hub库会自动重建缓存目录并重新下载所需文件。
• 手动创建基础缓存目录（可选）：若需提前搭建目录框架，可手动创建默认缓存路径~/.cache/huggingface/hub，不过通常无需手动操作，执行下载命令时会自动生成完整结构。
• 检查自定义缓存路径配置：如果之前设置过HF_HOME环境变量指定缓存路径，通过echo $HF_HOME确认路径是否正确，若路径错误则重新设置后再执行下载操作。

内容的提问来源于stack exchange，提问作者Phantom Pang