如何更新 ComfyUI

更新任意安装类型的 ComfyUI：便携版更新脚本、Desktop 更新、手动安装的 git pull，以及常见更新问题的修复。

尽管我们可能已经在不同版本的各部分章节，对于 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 仓库

⚠️ 危险：请谨慎使用 update_comfyui_and_python_dependencies.bat！

这个脚本比普通更新更彻底，它会：

• ✅ 更新 ComfyUI 代码本身
• ✅ 更新 PyTorch（针对 NVIDIA GPU CUDA 12.9）
• ✅ 重新安装所有 Python 依赖包

风险提示：

• 可能与现有配置产生依赖冲突
• 可能破坏依赖特定包版本的自定义节点
• 可能覆盖手动配置的包版本

⚠️ 仅在以下情况使用此脚本：

• 需要修复依赖问题时
• 进行大版本更新时
• 日常更新建议使用 update_comfyui.bat

运行此脚本前必须：

1. 备份整个 ComfyUI 安装目录
2. 记录已安装的自定义包版本
3. 做好重新安装自定义节点的准备

桌面版

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

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

手动安装

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

更新前准备

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

更新步骤

1. 激活虚拟环境

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

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

2. 拉取最新代码

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

   cd <ComfyUI安装路径>
   git pull

3. 更新依赖

   安装或更新 ComfyUI 的依赖包：

   pip install -r requirements.txt

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

4. 重启 ComfyUI

   更新完成后重新启动 ComfyUI：

   python main.py

切换版本（可选）

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

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

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

# 返回最新版本
git checkout master

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

ComfyUI 的不同版本说明

ComfyUI 有桌面版、便携版、手动安装三种安装方式，不同方式的更新方法不同（见上方的分方式说明）。如果你还不清楚自己用的是哪种安装方式，或想了解它们的区别，请见安装方式怎么选。

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

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

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

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

comfyui-frontend-package   # ComfyUI 前端功能
comfyui-workflow-templates # ComfyUI 工作流模板  
comfyui-embedded-docs      # ComfyUI 节点的帮助文档
comfy-kitchen              # ComfyUI 核心工具库
comfy-aimdo                # ComfyUI 核心工具库

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

• ComfyUI_frontend - 前端界面和交互功能
• workflow_templates - 预置工作流模板
• comfyui-embedded-docs - 节点帮助文档
• comfy-kitchen - 支持多种计算后端的 Diffusion 推理快速内核库
• comfy-aimdo - AI 模型按需卸载分配器

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

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

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

常见更新问题

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

未正确更新依赖

经常有用户只是使用 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 管理虚拟环境，请先激活虚拟环境：

   conda activate comfyui  # 或其他环境名

2. 更新代码

   这一步我们需要进入 ComfyUI 的根目录，并使用 Git 更新对应的代码。

   cd <ComfyUI根目录>
   git pull

3. 更新依赖

   这一步我们需要更新 ComfyUI 的依赖，这个步骤非常重要，特别是前端 comfyui-frontend-package 的更新

   pip install -r requirements.txt

桌面版

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

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

依赖更新故障排除

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

1. 检查网络连接

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

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

2. 逐个安装核心包

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

   然后按照指定版本安装（使用 requirements.txt 中的版本号）：

   pip install comfyui-frontend-package==<version> 
   pip install comfyui-workflow-templates==<version>
   pip install comfyui-embedded-docs==<version>
   pip install comfy-kitchen==<version>
   pip install comfy-aimdo==<version>

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

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

这是最常见的问题之一：

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

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

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

不同版本的区别

开发版本 (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. 或者使用便携版/手动安装来体验最新功能

更新后出现错误怎么办？

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

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

故障排查

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

如何了解最新功能？

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