如何修改Python的.cache文件夹路径？解决Hugging Face缓存占C盘问题

一、通用Python缓存全局设置 #

大部分遵循XDG规范的Python库会读取XDG_CACHE_HOME环境变量作为缓存根目录，设置后.cache的内容会自动转移到指定路径：

• 打开「系统环境变量」面板（右键此电脑→属性→高级系统设置→环境变量）
• 在「系统变量」中新建变量：
  • 变量名：XDG_CACHE_HOME
  • 变量值：目标路径（如D:\Dev\PythonGlobalCache）
• 保存后重启终端或IDE，新的缓存会写入该路径

二、Hugging Face专属缓存设置 #

针对Hugging Face的模型、数据集，建议单独设置专属环境变量，更精准：

• 设置模型缓存变量TRANSFORMERS_CACHE：
  变量值设为你想要的模型存储路径（如D:\Dev\HuggingFaceModels）
• 设置数据集缓存变量DATASETS_CACHE：
  变量值设为数据集存储路径（如D:\Dev\HuggingFaceDatasets）

三、临时代码内设置（无需重启系统） #

如果只是临时修改当前项目的缓存路径，可以在代码开头添加：

import os
# 设置Hugging Face模型缓存
os.environ['TRANSFORMERS_CACHE'] = 'D:\\Dev\\HuggingFaceModels'
# 设置数据集缓存
os.environ['DATASETS_CACHE'] = 'D:\\Dev\\HuggingFaceDatasets'
# 设置全局Python缓存
os.environ['XDG_CACHE_HOME'] = 'D:\\Dev\\PythonGlobalCache'

四、迁移已下载的缓存 #

如果C盘已经有下载好的模型/缓存文件，直接将C:\Users\你的用户名\.cache\huggingface文件夹复制到新设置的路径下，即可避免重新下载大文件。

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