ComfyUI 提示 No module named 'torch'：修復步驟
修復 ComfyUI portable、venv 和受管安裝中的 ModuleNotFoundError: No module named 'torch'，並確認修復後的 Torch 仍支援 CUDA。
當啟動 ComfyUI 的 Python 無法匯入 Torch 時，ComfyUI 會因為 ModuleNotFoundError: No module named 'torch' 停止；使用者也常搜尋 No module named torch 或 ComfyUI torch missing。這是核心 runtime 故障，不是可以忽略的警告。
正確修法是：把 CUDA 版 Torch 裝進「真正啟動 ComfyUI 的那個 Python」，然後確認它不是 CPU-only build。
.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX把 cuXXX 換成 PyTorch 官方安裝選擇器裡符合你環境的 CUDA wheel 標籤。重新啟動前，確認 torch.version.cuda 不是 None，且 torch.cuda.is_available() 回傳 True。
快速判斷
| 你看到什麼 | 代表什麼 | 第一個動作 |
|---|---|---|
ModuleNotFoundError: No module named 'torch' | 啟動 ComfyUI 的 Python 缺少 Torch | 在目前 ComfyUI Python 裡安裝 Torch |
系統 Python 的 pip show torch 正常，但 ComfyUI 仍失敗 | 裝錯 Python 環境 | 使用 python_embeded\python.exe 或目前 venv |
import torch 成功，但版本尾端是 +cpu | 只修好匯入，沒有修好 GPU build | 換成匹配的 CUDA wheel |
下一個錯誤變成 No module named 'torchvision' / 'torchaudio' | 相鄰核心套件仍缺失 | 在同一環境繼續修這些套件 |
torch.cuda.is_available() 是 False | GPU build 不匹配、wheel 錯誤或驅動問題 | 進入 CUDA 驗證步驟 |
AssertionError: Torch not compiled with CUDA enabled | Torch 已安裝，但它是 CPU-only 或 CUDA build 不對 | 看 Torch not compiled with CUDA enabled |
第 1 步：確認 ComfyUI 實際使用哪個 Python
Windows portable：
.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s -m pip show torch torchvision torchaudio手動 venv：
.\venv\Scripts\activate
python -c "import sys; print(sys.executable)"
python -m pip show torch torchvision torchaudio如果你用的是 ComfyUI Desktop 或其他受管 Launcher，請使用 App 自己的終端或環境工具，不要預設它一定有 python_embeded。
第 2 步：在目前環境安裝 Torch
依你的 GPU、驅動、Python 版本與 PyTorch 支援矩陣，到 PyTorch 官方安裝選擇器選 CUDA wheel。不要從裸 pip install torch 開始；它可能只修回匯入，卻裝成 CPU-only。
Windows portable 請透過 embedded Python 執行所選命令：
.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX手動 venv 先啟用環境，再用同樣的 --index-url 模式執行 python -m pip。記得把 cuXXX 換成你支援的 CUDA wheel 標籤。
第 3 步：確認沒有裝成 CPU Torch
在啟動 ComfyUI 的同一個 Python 中執行：
.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available()); print(torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'no cuda')"如果輸出版本以 +cpu 結尾，且顯示 None False，就是 CPU-only build。回到第 2 步，用 CUDA wheel 命令重新安裝。不要把地區鏡像混進主要命令；網路存取和套件來源可信度要分開處理。
如果 Torch 能匯入但 CUDA 仍失敗，繼續看 ComfyUI 中 Torch Not Compiled With CUDA Enabled。
第 4 步：重啟並讀下一個第一錯誤
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build受損的 portable 環境裡，下一個阻斷點常是另一個核心套件，例如 safetensors、packaging、numpy、torchvision 或 torchaudio。繼續在同一個 Python 裡修「下一條第一錯誤」，不要切到隨機套件命令。如果環境一直從一個核心套件壞到另一個核心套件，請使用 逐包修復 ComfyUI portable 相依性。
不要這樣做
- ComfyUI 從
python_embeded或 venv 啟動時，不要把 Torch 裝進系統 Python - 不要把
import torch成功等同於 CUDA 已修好 - 一般 wheel 版 ComfyUI 環境不要先重裝 CUDA Toolkit
- 還沒搞清楚第一個阻斷點前，不要從
pip install -r開始 - 核心 runtime 沒恢復前，不要重裝自訂節點
相關文檔
- ComfyUI 中 Torch Not Compiled With CUDA Enabled
- 逐包修復 ComfyUI portable 相依性
- ComfyUI 中未安裝 comfyui-frontend-package
- ComfyUI 相依性衝突
- 安裝自訂節點後 ComfyUI 出問題？不用重裝即可恢復
參考來源
先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。
下載 Wonderful Launcher查看 credits 方案這篇文件解決了你的問題嗎？
你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。