ComfyUI版本升级注意事项

ComfyUI版本升级注意事项

一、升级前准备

1. 备份重要数据：升级前务必备份工作流文件（如.json格式）、自定义节点目录（custom_nodes）、配置文件（如extra_model_paths.yaml、settings.json）。这些文件包含用户自定义的工作流逻辑、节点设置及模型路径，避免升级过程中因意外导致数据丢失。
2. 检查系统环境：确保系统满足新版本要求（如Python版本、PyTorch版本）。例如，ComfyUI v0.3.61需要Python 3.10及以上，PyTorch 2.5.1+cu124（CUDA 12.4）；若使用AMD GPU，需提前设置环境变量TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1以启用实验性内存高效注意力机制。
3. 查看更新日志：通过官方GitHub（如ComfyUI主项目、ComfyUI-Impact-Pack）查看新版本变更内容（新增功能、修复问题、废弃特性），确认升级是否符合需求，避免因特性调整影响现有工作流。

二、升级操作步骤

1. 核心本体升级

• 桌面用户（推荐）：通过ComfyUI Manager（内置升级工具）一键升级。操作路径：点击ComfyUI界面左下角「设置」→「ComfyUI Manager」→ 选择「Update ComfyUI」（升级至最新版）或「Switch ComfyUI」（切换至指定版本）→ 点击「Restart」重启生效。
• 手动升级（Git方式）：

① 打开终端，进入ComfyUI安装目录（如cd ~/ComfyUI）；
② 拉取最新代码：git fetch --tags（获取远程标签）；
③ 切换至目标版本：git checkout v0.3.61（替换为所需版本号）；
④ 安装依赖：pip install -r requirements.txt（更新依赖库）；
⑤ 重启服务：python main.py或通过启动器重启ComfyUI。

2. 前端版本升级

ComfyUI采用前后端分离架构，前端页面（如界面布局、操作按钮）需单独升级：

• 修改requirements.txt文件：找到comfyui-frontend-package行，将版本号更新为目标版本（如comfyui-frontend-package==1.28.0，版本号可从ComfyUI Frontend GitHub Releases页面获取）；
• 安装依赖：在ComfyUI根目录执行python -m pip install -r requirements.txt；
• 重启ComfyUI：使前端变更生效。

3. 第三方节点包升级

若使用了第三方节点包（如ComfyUI-Impact-Pack、ComfyUI-Advanced-Control），需单独处理：

• 完全卸载旧版本：关闭ComfyUI，手动删除custom_nodes目录下对应的节点包文件夹（如ComfyUI-Impact-Pack）；
• 安装最新版：通过ComfyUI Manager或pip install命令安装最新版（如pip install comfyui-impact-pack）；
• 安装分离组件：部分节点包（如Impact-Pack）进行了架构调整（如impact_subpack分离为独立包），需额外安装子组件（如ComfyUI-Impact-Subpack）；
• 备份自定义设置：若对节点包有自定义修改（如修改节点代码），建议提前备份，避免升级后覆盖。

三、升级后验证与适配

1. 检查版本一致性：确认ComfyUI核心版本、前端版本及第三方节点包版本兼容。例如，ComfyUI v0.3.61需搭配前端版本≥1.26.0（参考官方发布说明）；
2. 测试核心功能：运行简单工作流（如文本生成图像），检查模型加载、节点执行、图像输出等功能是否正常；
3. 适配自定义工作流：若升级后工作流报错（如节点类型不匹配、接口变更），需根据新版本API调整工作流：

• 节点类型检查：新版强化了类型检查（如comfy_types/node_typing.py），确保自定义节点的输入/输出类型与新版一致；
• API变更适配：若模型加载接口有调整（如model_management.py中的新方法），需修改自定义节点中的相关代码。

四、常见问题解决

1. 权限问题（Windows）：升级时若出现“权限拒绝”（如无法删除.git目录），可尝试：

• 以管理员身份运行终端；
• 关闭杀毒软件（避免拦截文件操作）；
• 手动删除旧版本目录后重新安装。

1. 配置文件冲突：升级后若出现配置错误（如extra_model_paths.yaml中新增选项报错），可将备份的配置文件（如extra_model_paths.yaml.bak）复制到原位置，手动合并新配置项。
2. 前端版本不兼容：若升级后前端界面显示异常（如按钮缺失、布局错乱），需确保前端版本与核心版本匹配，可通过pip install --upgrade comfyui-frontend-package重新安装前端。