加载报错解决说明

我们在使用ComfyUI时，经常会遇到需要安装些新的插件，或是对插件进行升级，又或是对他人工作流载入后的学习优化。

对于没有python基础的我们，在使用ComfyUI的朋友们在这方面会遇到些报错等各种问题。这些问题总的来说，主要分：因为依赖环境没有配置好，有的是因为相应插件需要的模型文件没放对路径，有的则是因为ComfyUI本体或者是插件没有及时更新等原因，导致工作流无法正常运行。

今天我们跟大家分享这个比较简单的python命令使用，我们称之为“三板斧”，即用手动安装、更新和配置依赖的方法，希望大家了解后使用，能帮助大家通过这种方式来解决大部分ComfyUI的插件使用中遇到的问题。

当然，要使用这个python命令“三板斧”，首先你需要先在电脑上安装一个git安装包，这个我们也收录到本次资料包的目录下，文末可取。

首先，我们先说说插件的安装。

我们平时安装ComfyUI的插件，大体上有三种方法，第一种就是直接在ComfyUI的管理器页面，进行搜索相应的插件后进行安装。

第二种是到这个插件的GitHub官网上，将这个插件的压缩包下载后解压到\ComfyUI\custom_nodes路径下。

第三种，也是我自己最常用的一种方式，就是打开这个插件的GitHub官网地址后，复制git链接，然后打开文件夹到\ComfyUI\custom_nodes路径，跟着在地址栏处，输入“cmd”进入这个路径下的命令窗口（则所执行的命令都是针对这个路径下的操作）。

然后在命令窗口中，执行命令“git clone”+“复制的git的链接”，回车，即可将此插件克隆到本地的插件目录中，重启ComfyUI后就可以使用。

【git pull】升级更新

其次，是对插件的升级更新。

分享插件的作者，随着ComfyUI使用生态的发展和进步，插件的作者也会不断对自己所做的插件进行迭代、优化，这就涉及到插件的更新升级。一般情况下我们可以用ComfyUI带的“管理器”进行更新即可。

也可以是打开某个需要更新的插件目录的文件夹后，在地址栏处，输入“cmd”进入这个路径下的命令窗口。输入“git pull”后，回车，即可完成该插件的更新。重启ComfyUI后生效。

【requirements.txt】依赖环境

依赖环境的配置

大多数的插件，在安装或升级后都可以直接通过重启ComfyUI后，即可使用。不过有的插件会因为其特别需要的环境配置，而我们的本地部署之前没有这种环境配置，会导致无法正常使用此插件。那么就需要我们执行一次环境配置的命令，为这个插件将环境配置补齐。

我们会发现，在大部分的插件目录下，都会有一个requirements.txt，这个文件就记录了这个插件所需要的环境配置要求。

具体的操作，我们只需要记住一条命令即可。

先打开ComfyUI目录的根目录（即整合包的根目录），由于大多数整合包都会将python包一并打包在整合包内，因此在这个整合包目录下执行的配置环境命令就能对这个整合包内的插件生效。

在此目录下，同样，通过地址栏内输入“cmd”打开弹出的命令窗口，在命令窗口中输入一条命令即可完成此插件的环境配置。我们拿“comfyui-mixlab-nodes”这个插件为例，为这个插件配置依赖环境，则命令如下：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\comfyui-mixlab-nodes\requirements.txt

回车后，即可执行该插件的依赖环境的配置。

依赖环境的排查

一般的问题，在用好这三板斧的情况下是可以解决问题的。

不过遇到二班的插件，比如Insightface，InstantID，之前我三板斧没搞定的，就需要具体看依赖环境是否对路，我是搞不定，不过我们的小伙伴虎哥倒是已经被我折腾得很熟悉了排除这类故障，特别是有不少依赖需要搭配cuda的，版本不统一，挂没挂上cuda都会影响到使用。可以在整合包目录的python包路径下，用“pip list”命令查看自己是否已经装有和装对插件所需要的依赖：

D:\ComfyUI_0511\python_embeded>pip list

torch            2.3.0+cu118

torch-complex        0.4.3

torchaudio          2.3.0+cu118

torchdiffeq         0.2.3

torchmetrics         0.11.4

torchsde           0.2.5

torchvision         0.18.0+cu118

xformers           0.0.26.post1+cu118