如何更新 ComfyUI

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

​

更新脚本位置

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

ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // 更新到最新开发版本
   ├── update_comfyui_stable.bat                    // 更新到最新稳定版本
   └── update_comfyui_and_python_dependencies.bat   // 更新依赖（问题修复时使用）

ComfyUI 桌面版采用自动更新机制，确保你始终使用最新版本，不过由于 Desktop 版本是基于稳定版本构建的，所以它的功能更新相对滞后，你也可以访问 下载页面 来获取最新版本。

​

自动更新设置

请确保在设置中已经启用自动更新功能：

​

手动检查更新

你也可以手动检查是否有可用的更新：

1. 点击菜单栏中的 菜单
2. 选择 帮助
3. 点击 检查更新

手动安装的 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

标准更新流程：

# 1. 激活虚拟环境
conda activate comfyui  # 或其他环境名

# 2. 更新代码
cd <ComfyUI安装路径>
git pull

# 3. 更新依赖（重要步骤）
pip install -r requirements.txt

强制重新安装核心依赖：

# 强制重新安装所有依赖（按照 requirements.txt 指定版本）
pip install -r requirements.txt --force-reinstall

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

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

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

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

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

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

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

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

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