[StreamDiffusion] 修復 ImportError: cannot import name 'cached_download' from 'huggingface_hub' 錯誤

2025.03.26 / StreamDiffusion
近期在研究 StreamDiffusion，發現在 Python 3.10 中執行時會出現「ImportError: cannot import name ‘cached_download’ from ‘huggingface_hub’」錯誤，導致無法下載模型。查資料後得知是因為 Hugging Face 的破壞性變更棄用了 cached_download 方法，直接原地改成 huggingface_hub 即可，本文將說明如何動手修正此問題。

重現錯誤

這個錯誤是在 安裝 StreamDiffusion 開發環境 時發生的，當時的系統環境是這樣：

軟體名稱版本
Windows 1123H2
Python3.10
CUDA12.4
PyTorch2.6.0

在安裝 StreamDiffusion 需要的 TensorRT 時會出現「ImportError: cannot import name ‘cached_download’ from ‘huggingface_hub’」錯誤。

解決方法

點一下錯誤說明中最後列出的 dynamic_modules_utils.py 路徑，再點「在編輯器中開啟檔案」。

刪除第 28 行中的 cached_download：

往下滑到 285 行，將 cached_download 改成 hf_hub_download，最後長這樣：

存檔，重新執行之前的指令，問題應已解決！

參考資料

網路論壇

相關文章

Ted Liou

雲科碩士在讀中，專注於 Unity C#、TouchDesigner 技術。
只要願意以超連結標註本文，歡迎轉載或用於教材製作！