Hugging Face 缓存目录设置¶
要让 Hugging Face(包括 sentence-transformers)模型的缓存目录永久改到非 C 盘(例如 D:\HF_cache 或 E:\huggingface_hub),最推荐、最干净的方式是设置系统级或用户级的环境变量 HF_HOME。这样所有 Hugging Face 相关的库(transformers、sentence-transformers、huggingface_hub、datasets 等)都会自动使用新路径,无需每次在代码里写 cache_dir=...。
推荐方案:设置 HF_HOME 环境变量(永久生效)¶
- 按 Windows 键,搜索并打开 “编辑系统环境变量” 或 “环境变量”(英文系统是 “Edit the system environment variables”)。
- 在弹出的“系统属性”窗口,点击下方 “环境变量” 按钮。
- 在 “用户变量”(只影响当前用户)或 “系统变量”(影响所有用户,需要管理员权限)区域:
- 点击 “新建(N)”
- 变量名(Variable name):输入
HF_HOME(全大写) - 变量值(Variable value):输入你想要的路径,例如: 或 (建议新建一个专门的文件夹,不要用已有项目文件夹,避免混乱)
- 点击 确定 → 确定 → 确定 关闭所有窗口。
- 重要:关闭并重新打开你的 IDE(VS Code、PyCharm、Jupyter)、命令提示符 / PowerShell / Anaconda Prompt,让新环境变量生效,可能需要重启电脑。
以后 sentence-transformers 加载模型时,就会把所有下载的文件(model.safetensors、tokenizer.json、config 等)存到你指定的 HF_HOME/hub 目录下。