如何更新 ComfyUI

便携版

ComfyUI 便携版提供了便捷的批处理脚本来完成更新操作。

### 更新脚本位置 在便携版安装目录下的 update 文件夹中，可以找到以下更新脚本：

ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // 更新到最新开发版本
   ├── update_comfyui_stable.bat                    // 更新到最新稳定版本
   └── update_comfyui_and_python_dependencies.bat   // ⚠️ 危险：重装依赖 - 可能导致冲突

桌面版

Comfy 桌面版使用 Comfy Engine 作为包管理器来管理 ComfyUI。要更新 ComfyUI 本体，请打开 管理面板 的更新标签页，可以选择 稳定版（默认）和 GitHub 最新版 更新频道。

桌面版客户端本身的更新是自动的，与 ComfyUI 引擎更新相互独立。

手动安装

手动安装的 ComfyUI 需要通过 Git 命令来完成更新操作。

更新前准备

确保你的系统已安装 Git 并且 ComfyUI 是通过 Git 克隆安装的。

更新步骤

# 对于 conda 环境
conda activate comfyui

# 对于 venv 环境
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

cd <ComfyUI安装路径>
git pull

pip install -r requirements.txt

python main.py

切换版本（可选）

如果需要切换到特定版本，可以使用以下命令：

# 查看提交历史
git log --oneline

# 切换到特定提交
git checkout <commit-hash>

# 返回最新版本
git checkout master

未正确更新依赖

经常有用户只是使用 git pull 命令来更新 ComfyUI 的代码，但忽略了核心依赖更新，导致出现以下问题：

• 前端功能缺失或显示异常
• 找不到新增的工作流模板
• 节点帮助文档过时或缺失
• 新功能没有对应的前端支持

请在使用了 git pull 命令后，在对应的 ComfyUI 环境使用 pip install -r requirements.txt 命令来更新依赖。

依赖更新失败

如果依赖更新失败常见可能是网络或者计算机权限问题，目前在更新过程中如果出现了核心依赖失败的情况会回退到旧版本，通常你可以在启动日志中看到类似下面的日志：

Falling back to the default frontend.
ComfyUI frontend version: xxx

请按以下步骤排查：

1. 在对应的环境中使用 pip list 命令来查看当前安装的依赖包，如果发现有版本不一致的情况，请在对应的 ComfyUI 环境使用 pip install -r requirements.txt 命令来尝试再次更新依赖。
2. 如果更新后仍然存在问题，请检查网络连接是否正常，如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库。
3. 如果仍然存在问题，请检查计算机权限是否正常，如果需要管理员权限，请使用管理员权限运行命令行。

便携版

推荐方法：使用 ComfyUI_windows_portable\update\update_comfyui.bat 这个批处理脚本，这个脚本会同时更新 ComfyUI 代码和所有 Python 依赖包。

手动更新依赖： 如果你需要手动更新依赖，可以使用以下命令：

# 在便携版目录下打开命令行
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

手动安装

标准更新流程：

conda activate comfyui  # 或其他环境名

cd <ComfyUI根目录>
git pull

pip install -r requirements.txt

桌面版

桌面版通常会自动处理依赖更新。如果遇到问题：

1. 检查自动更新设置是否启用
2. 手动触发更新：菜单 → 帮助 → 检查更新
3. 重新安装桌面版（极端情况下）

开发版本 (nightly)

• 特点：包含最新的 commit 代码
• 优势：可以第一时间体验到最新功能和改进
• 风险：可能存在未发现的 bug 或不稳定因素
• 适合人群：开发者、测试用户、想要体验最新功能的用户

稳定版本 (release)

• 特点：经过测试和验证的稳定代码
• 优势：稳定性高，适合生产环境使用
• 劣势：功能更新会有延迟，可能落后开发版本数周或数月
• 适合人群：需要稳定性的用户、生产环境用户

便携版

使用 update_comfyui.bat 而不是 update_comfyui_stable.bat：

# 开发版本（最新功能）
double-click: update_comfyui.bat

# 稳定版本
double-click: update_comfyui_stable.bat

手动安装

# 切换到开发版本
git checkout master
git pull

# 切换到最新稳定版本
git fetch --tags
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

桌面版

桌面版通常基于稳定版本构建,目前暂时不支持切换版本，如果你需要最新功能，建议：

1. 等待桌面版更新
2. 或者使用便携版/手动安装来体验最新功能