如何更新 ComfyUI

尽管我们可能已经在不同版本的各部分章节，对于 ComfyUI 的更新过程都有所说明，但是为了方便用户能够更清楚的了解 ComfyUI 的更新过程，我们会在这部分对于 ComfyUI 的更新进行详细的说明。

如何更新 ComfyUI?

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

更新脚本位置

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

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

更新过程中请保持网络连接稳定，如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库

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

更新脚本位置

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

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

更新过程中请保持网络连接稳定，如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库

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

自动更新设置

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

手动检查更新

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

点击菜单栏中的 菜单
选择 帮助
点击 检查更新

桌面版会自动处理所有更新过程，包括 ComfyUI 核心代码和相关依赖的更新

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

更新前准备

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

更新步骤

激活虚拟环境

首先激活 ComfyUI 的 Python 虚拟环境（如果使用了虚拟环境）：

# 对于 conda 环境
conda activate comfyui

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

拉取最新代码

进入 ComfyUI 安装目录并拉取最新代码：

cd <ComfyUI安装路径>
git pull

更新依赖

安装或更新 ComfyUI 的依赖包：

pip install -r requirements.txt

请确保当前处于 ComfyUI 的虚拟环境中，避免污染系统级 Python 环境

重启 ComfyUI

更新完成后重新启动 ComfyUI：

python main.py

切换版本（可选）

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

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

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

# 返回最新版本
git checkout master

建议定期更新以获得最新功能和安全修复，同时推荐使用稳定版本以确保系统稳定性

ComfyUI 的不同版本说明

首先取决于你安装方式的不同，目前 ComfyUI 有以下的几种安装版本，下面的相关链接中已经包含了针对不同版本的更新说明。

ComfyUI 桌面版

ComfyUI 便携版(Windows)

手动安装 ComfyUI

在更新 ComfyUI 时都需要更新什么内容？

目前 ComfyUI 的更新主要需要确保两部分内容：

更新 ComfyUI 的核心代码
更新 ComfyUI 的核心依赖，包括必要的 Python 依赖和 ComfyUI 的功能依赖包。

核心代码：新的节点，新的模型支持，新的功能等。 核心依赖：主要包括 ComfyUI 的前端功能，工作流模板，节点帮助文档等。

comfyui-frontend-package   # ComfyUI 前端功能
comfyui-workflow-templates # ComfyUI 工作流模板  
comfyui-embedded-docs      # ComfyUI 节点的帮助文档

目前这三个核心依赖项目分别在不同的仓库中维护：

ComfyUI_frontend - 前端界面和交互功能
workflow_templates - 预置工作流模板
comfyui-embedded-docs - 节点帮助文档

另外很有必要说明的一点是，开发版本(nightly) 和稳定版本(release) 的区别：

开发版本(nightly)：最新 commit 的代码，你可以体验到我们最新提供的一些功能，但是也有可能存在一些潜在的问题
稳定版本(release)：是基于稳定版本构建，通常会滞后于开发版本，但是稳定性更高，我们会在相关功能发布稳定后对稳定版本进行支持

目前较多用户总是在更新过程中处于 release 版本或者桌面版，但是发现需要的功能是开发版本中提供的对应版本并不存在，对于此情况请检查本地 ComfyUI/requirements.txt 和nightly 版本的依赖是否一致，来确定当前是否所有依赖都是我们最新版本的功能支持。

常见更新问题

更新后前端、工作流模板、节点帮助文档等缺失或滞后

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

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

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

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

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

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

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

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

请按以下步骤排查：

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

如何正确更新核心依赖

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

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

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

推荐方法：使用 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

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

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

依赖更新故障排除

如果依赖更新失败，请按以下步骤排查：

检查网络连接

如果位于中国大陆地区，请确保能够访问 PyPI 或配置中国境内镜像：

# 使用清华大学镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

逐个安装核心包

如果批量安装失败，可尝试逐个安装。首先查看 ComfyUI/requirements.txt 中的版本要求：

然后按照指定版本安装：

pip install comfyui-frontend-package==1.17.11 
pip install comfyui-workflow-templates==1.0.0
pip install comfyui-embedded-docs==1.0.0

建议使用 ComfyUI/requirements.txt 中指定的确切版本号，不要自行升级到最新版本，这可能导致兼容性问题。

为什么我更新后找不到新功能？

这是最常见的问题之一：

如果你使用的是桌面版，因为桌面版是基于稳定版本构建的，它的功能更新相对滞后
请确定你使用的是开发版本(nightly)，而不是稳定版本(release)

另外还需要确保在更新过程中对应的依赖已经成功更新，如果更新后仍然存在问题，请参考依赖更新故障排除章节来排查问题。

如何切换到开发（nightly）版本或者稳定（release）版本？

不同版本的区别

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

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

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

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

使用 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`)

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

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

更新后出现错误怎么办？

检查依赖：运行 pip install -r requirements.txt 确保所有依赖都已更新
检查自定义节点：某些自定义节点可能与新版本不兼容
回退版本：如果问题严重，可以回退到之前的稳定版本

如果出现问题，可以参考我们的问题排查页面来解决。

故障排查

查看如何进行 ComfyUI 的故障排查

如何了解最新功能？

GitHub Releases：查看 ComfyUI Releases 了解稳定版本更新
GitHub Commits：查看最新提交了解开发进度
社区讨论：关注我们的博客和推特来了解最新动态

开始使用

界面指南

教程示例

故障排除

社区

如何更新 ComfyUI