ComfyUI 更新 Python 依赖包 requirements.txt 冲突怎么解决

解决 ComfyUI 更新 Python 依赖包冲突最推荐的做法是使用 ComfyUI Manager 自动处理依赖，或在独立的虚拟环境中重新安装 requirements.txt。适用场景为本地部署更新后启动报错，风险边界是强制升级可能导致部分旧版自定义节点失效。

先说结论：优先使用工具管理依赖，手动修改 requirements.txt 仅作为最后手段，操作前必须备份环境。

命令速用版

在 ComfyUI 根目录下执行以下命令更新核心依赖，适用于标准 Git 部署环境。

git pull
pip install -r requirements.txt `--upgrade`

若使用 Conda 环境，请先激活环境再执行 pip 命令。

依赖冲突本质是 pip 包管理器无法同时满足多个包对同一库的版本要求。

ComfyUI 核心更新可能提升 PyTorch 版本下限，而旧版自定义节点可能锁定低版本依赖，导致 requirements.txt 安装失败或运行时导入错误。Python 环境全局污染也会加剧此类问题，因此隔离环境是关键。

按顺序执行以下步骤，每步完成后检查是否有报错中断。

步骤 1：备份当前环境

复制整个 ComfyUI 文件夹或导出当前 pip 列表，防止更新后无法回滚。

pip freeze > requirements_backup.txt

步骤 2：更新 ComfyUI 核心

拉取最新代码，确保 requirements.txt 是最新版本。

git pull

步骤 3：安装依赖

使用 `--upgrade` 参数尝试更新冲突包，若报错则记录具体包名。

pip install -r requirements.txt `--upgrade`

步骤 4：处理自定义节点依赖

启动 ComfyUI Manager，点击 Manager 按钮，选择 Install Missing Custom Nodes 或 Update All。

查看启动日志中是否有红色报错信息，并确认界面节点列表是否完整。

启动 ComfyUI 后，观察控制台输出，若出现 ImportError 或 ModuleNotFoundError 则未生效。在网页界面检查关键节点（如 Load Checkpoint, KSampler）是否显示为红色缺失状态。

避免在全局 Python 环境中操作，不要混用 Conda 和 pip 安装同一批包。

部分节点依赖特定 CUDA 版本的 torch，强制升级可能导致 CUDA 不匹配报错。Windows 用户注意路径不要包含中文，以免 pip 安装解码失败。

不建议直接删除，除非确认该包非核心必需。

手动删除可能导致核心功能缺失，应先尝试升级冲突包版本，仅在被明确告知某包可忽略时才修改文件。

根据显卡驱动版本卸载现有 torch 并重装匹配版本。

先执行 pip uninstall torch torchvision torchaudio，再去 PyTorch 官网查询对应 CUDA 版本的安装命令重新安装。

检查网络连接或手动 pip 安装报错中提到的包名。

网络问题可更换 pip 源，若包本身缺失则需在节点 GitHub 页面查找替代方案或联系作者。