ComfyUI 相依性衝突：無需重裝即可修復

如果你搜尋的是 comfyui dependency conflicts、sensevoice-onnx setuptools conflict comfyui、custom node broke environment 或 pip install broke comfyui，簡短的答案是：

不要先重新安裝。找出是哪一個插件匯入或套件變更破壞了環境，然後修復盡可能小的那一層。

如果你的 pip check 輸出恰好是 sensevoice-onnx requires setuptools<=65.0，請使用專用的 SenseVoice-ONNX setuptools 衝突修復指南，按照最小修復路徑操作。

相依性衝突是許多 ComfyUI 環境的隱形殺手。一個插件安裝了某個套件，該套件變更了 PyTorch、NumPy、OpenCV 或其他共享函式庫，結果昨天還能正常運行的工作流今天突然無法運行。

代價高昂的不只是那個損壞的套件，而是隨之而來的恢復循環：

• 查看日誌
• 隨意嘗試 pip install 命令
• 重啟 ComfyUI
• 又破壞了別的東西
• 開始懷疑自己是否需要重裝所有內容

本指南教你如何診斷、修復並預防這些問題，而不是將重裝當作預設答案。

值得儘早識別的衝突模式

以下特徵出現頻率足夠高，值得一眼認出：

快速解答

修改套件之前的案例審查分級

已審查的修復案例表明，許多"相依性衝突"會話實際上比套件衝突早一層或晚一層。在運行安裝命令之前，請先進行以下邊界檢查：

只有當故障確實出現在共享 Python 套件層時，才繼續閱讀本頁。如果下一個阻塞項是模型文件、節點註冊表或 Torch CUDA 建置，修復套件只會讓環境更嘈雜，卻無法解決工作流問題。

常見衝突特徵

第一步：診斷

檢查匯入失敗

查看 ComfyUI 啟動日誌中包含 IMPORT FAILED 的行：

IMPORT FAILED: ComfyUI-ExampleNode
ModuleNotFoundError: No module named 'somepackage'

使用 pip 檢查

在啟動 ComfyUI 的相同 Python 環境中運行 pip check：

第二步：分類問題

硬性阻塞

優先修復這些：

• torch 不匹配或僅有 CPU 版 Torch。如果 ComfyUI 報告 Torch not compiled with CUDA enabled，在變更插件套件之前先使用 Torch CUDA 修復指南。
• 原生 wheel 匯入失敗，例如 DLL load failed while importing cv2。

軟性漂移

監控這些，而非急於變更環境：

• pip check 報告版本宣告不匹配，但 ComfyUI 能啟動、插件能匯入、工作流能運行。不要為了讓 pip check 看起來乾淨而"修復"警告。

第三步：修復

規則 1：保護核心運行時

這些套件不能被插件安裝意外變更：torch、numpy、pillow、opencv-python、transformers。 安裝插件相依性之前，預覽將要發生的變更：

python -m pip install -r requirements.txt --dry-run

規則 2：使用正確的 Python

直接使用 pip install 存在風險，因為它可能指向系統的 Python。

相關指南

• 無需重裝 Torch 即可修復損壞的 ComfyUI 免安裝版相依性
• 如何修復 ComfyUI 插件匯入失敗錯誤
• ComfyUI 相依性衝突
• 安全安裝自定義節點
• ComfyUI 中 Safetensors 檔案的存放位置