HuggingFace下載的模型緩存到了C盤,如何安全遷移到其他盤
- ? 方法一:通過環境變量永久遷移緩存目錄(**推薦**)
- 步驟如下:
- 1?? 在 D 盤創建一個目錄(比如):
- 2?? 設置環境變量(`HF_HOME`)
- ? 方法 A:代碼中設置(只對當前運行有效)
- ? 方法 B:永久設置(推薦)
- 3?? 把你原來的模型文件夾**剪切**到新位置:
- 4?? 重新運行你的程序,驗證是否成功
- ? 方法二:使用 `TRANSFORMERS_CACHE`(僅限 Transformers,不推薦)
- ? 總結
Hugging Face的詞嵌入模型文件目錄默認緩存在C盤,比較占用空間,是否能遷移到D盤呢,我的C盤沒有空間了。C:\Users\你的用戶名.cache\huggingface\hub\models–BAAI–bge-large-zh-v1.5\snapshots\
當然!你完全可以把 Hugging Face 的模型緩存目錄遷移到 D 盤,從而釋放 C 盤空間 ?。
? 方法一:通過環境變量永久遷移緩存目錄(推薦)
這是 Hugging Face 官方支持的方式,可以把 .cache/huggingface
整個目錄遷移到 D 盤。
步驟如下:
1?? 在 D 盤創建一個目錄(比如):
D:\HuggingFaceCache
2?? 設置環境變量(HF_HOME
)
? 方法 A:代碼中設置(只對當前運行有效)
在你的 Python 腳本開頭加入:
import os
os.environ["HF_HOME"] = "D:/HuggingFaceCache"
? 方法 B:永久設置(推薦)
如果你想所有 Python 項目都默認使用 D 盤:
-
打開 Windows 的“系統環境變量”設置
-
新建一個用戶變量:
- 變量名:
HF_HOME
- 變量值:
D:\HuggingFaceCache
- 變量名:
重啟終端或電腦后生效。
3?? 把你原來的模型文件夾剪切到新位置:
例如:
從:
C:\Users\你的用戶名\.cache\huggingface\hub\models--BAAI--bge-large-zh-v1.5\
剪切到:
D:\HuggingFaceCache\hub\models--BAAI--bge-large-zh-v1.5\
📌 注意保持結構一致,hub/models--...
的路徑不能改變。
4?? 重新運行你的程序,驗證是否成功
你可以加一段打印緩存路徑的代碼來確認:
from huggingface_hub import hf_hub_download
print("Hugging Face 緩存路徑:", os.getenv("HF_HOME", "~/.cache/huggingface"))
? 方法二:使用 TRANSFORMERS_CACHE
(僅限 Transformers,不推薦)
Hugging Face 支持另一個環境變量叫:
TRANSFORMERS_CACHE=D:/my_cache_dir
但它只會影響 transformers
庫,不影響 sentence-transformers
或 datasets
等,所以推薦使用統一的 HF_HOME
。
? 總結
操作 | 推薦 | 說明 |
---|---|---|
設置 HF_HOME | ????? | 官方推薦方式,統一管理緩存目錄 |
改 TRANSFORMERS_CACHE | ?? | 僅部分模塊支持,不推薦 |
手動復制模型 | ? | 易出錯,不建議 |