安裝 ComfyUI 自定義節點而不把環境裝壞

如果你要安裝 ComfyUI 自定義節點，常見節點優先用 Manager，只有你明確知道要裝哪個倉庫時，才建議手動 Git clone。

自定義節點本質上就是社區插件。它們可以給 ComfyUI 增加換臉、視頻、超分、工作流整理等能力，但它們也是最容易把一個本來正常的環境裝壞的來源之一。

快速結論

如果你搜索的就是 ComfyUI Manager failed to get custom node list，這篇只做背景說明，真正的修法見 ComfyUI Failed to Get Custom Node List。

安裝方法

方法 1：ComfyUI Manager（推薦）

ComfyUI Manager 是最近版本 ComfyUI 的官方包管理層。 在當前的 Desktop 構建裡，它通常默認已經帶上；在較新的 portable 或手動安裝中，它通常也已經併入核心，但可能還需要補依賴並打開 manager 開關。

Desktop 用戶

ComfyUI Desktop 一般默認啟用 Manager。重啟後看工具欄裡是否已經出現 Manager 按鈕。

近期 portable 用戶

在 portable 根目錄執行：

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

近期手動安裝用戶

激活和啟動 ComfyUI 相同的 venv，然後執行：

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

舊版回退方案

如果你的構建仍然要求舊式插件安裝，就在 custom_nodes 下 clone：

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-manager

Manager 可用之後，你就可以在工具欄裡：

• 瀏覽可安裝節點
• 一鍵安裝節點
• 更新已安裝節點
• 對導入工作流執行缺失節點安裝

方法 2：手動 Git clone

1. 在 ComfyUI/custom_nodes/ 打開終端
2. clone 倉庫：

cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git

3. 只有在節點目錄裡真的有 requirements.txt 時，才安裝它的依賴，而且必須用 啟動 ComfyUI 的同一個 Python：

4. 重啟 ComfyUI

方法 3：直接複製單文件節點

有些簡單節點只是一個 .py 文件，可以直接放進 custom_nodes/：

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

然後重啟 ComfyUI。

常見熱門節點

紅節點到底意味著什麼

工作流裡的紅節點表示：ComfyUI 找不到這個工作流需要的後端節點類。 這和“插件有沒有放進文件夾”有關，但 不是同一件事。

實際鏈路是：

1. 工作流要求某個節點類
2. 某個自定義節點插件必須在啟動時註冊這個類
3. 插件只有在 Python 導入成功後才能註冊
4. 導入又可能依賴其他 Python 包、二進制 wheel、CUDA、PyTorch 或平臺特定依賴

所以紅節點既可能表示“插件沒裝”，也可能表示“插件目錄在，但導入失敗了”。

用 Manager 時：

1. 點擊 Manager
2. 點擊 Install Missing Custom Nodes
3. 安裝完成後重啟 ComfyUI
4. 看啟動日誌裡有沒有 IMPORT FAILED

不用 Manager 時：

1. 記下紅節點名稱
2. 去 GitHub 搜對應倉庫
3. 手動 clone
4. 重啟並看啟動日誌

怎麼更新自定義節點

用 Manager： 點擊 Manager > Update All

手動更新：

cd ComfyUI/custom_nodes/[node-name]
git pull
python -m pip install -r requirements.txt

如果你用的是官方 Windows portable 包，不要依賴系統 pip，而是改成：

.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[node-name]\requirements.txt

更新完仍然要重啟 ComfyUI。

更穩的安裝順序

如果這臺機器很重要，按這個順序更安全：

1. 一次只裝一個節點，或者一個節點家族
2. 每裝一次就重啟 ComfyUI
3. 看啟動日誌裡有沒有 IMPORT FAILED
4. 不要連續跑多個 requirements.txt
5. 只要出現依賴漂移跡象，就先停下來

開始時看起來慢一點，但比後面花兩小時救壞環境更省事。

常見問題

繼續深入

如果你要處理更復雜的插件管理、節點映射、倉庫遷移、批量安裝或 Git LFS 問題，看 插件管理。 如果你是在搭建複雜多工作流環境，看 工作流環境搭建。

如果你更想按症狀一路排查，直接看 故障排查決策樹。

如果你不想繼續手工反覆裝包，想走更偏恢復的路線，可以直接試 Wonderful Launcher。 如果環境已經不穩定，先用 Wonderful Launcher 檢查當前環境、任務日誌和依賴狀態；需要人工協助時再走支持渠道。

FAQ

最安全的安裝方式是什麼？

能用 Manager 就先用 Manager。手動安裝時，把節點 clone 到 ComfyUI/custom_nodes/，只安裝該節點自己的依賴，而且必須裝進啟動 ComfyUI 的同一個 Python 環境。

為什麼裝一個節點就把環境裝壞了？

因為很多節點會改共享核心包，例如 Torch、NumPy、OpenCV、Pillow、Transformers、Diffusers。 如果裝完節點後 ComfyUI 起不來，先看第一條 IMPORT FAILED 或 traceback，而不是繼續亂跑命令。

Manager 拿不到 custom node list 怎麼辦？

這通常不是普通節點安裝步驟的問題，而是 Manager 自己的 registry、網絡、緩存或 GitHub 訪問異常。直接看 ComfyUI Failed to Get Custom Node List。

相關文檔

• ComfyUI Failed to Get Custom Node List
• 裝完自定義節點後環境壞了怎麼辦
• ComfyUI Plugin Import Failed 怎麼修
• ComfyUI 依賴衝突

參考來源

• ComfyUI 官方自定義節點安裝指南
• ComfyUI Manager 官方安裝指南
• ComfyUI Manager 官方總覽
• ComfyUI-Manager GitHub repository