跳转到主要内容
尽管我们可能已经在不同版本的各部分章节，对于 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 的不同版本说明

首先取决于你安装方式的不同，目前 ComfyUI 有以下的几种安装版本，下面的相关链接中已经包含了针对不同版本的更新说明。
ComfyUI 桌面版目前支持 Windows 及 MacOS(Apple Silicon) 的独立安装，目前仍在 Beta 版本
由于 Desktop 总是基于稳定版本发布构建，所以我们最新的一些更新，对于 Desktop 来说可能需要等待一段时间才能体验到，如果你想要总是体验最新版本，请使用便携版或者手动安装
你可以从下面选择适合你的系统和硬件开始安装 ComfyUI
便携版是一个集成了独立的嵌入式 Python 环境的 ComfyUI 版本，使用便携版你可以体验到最新的功能，目前仅支持 Windows 系统

ComfyUI桌面版(Windows)安装指南

支持 Navida 显卡 和在 CPU 运行的 Windows ComfyUI 版本，始终使用最新 commit 的代码

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

目前 ComfyUI 的更新主要需要确保两部分内容：
  1. 更新 ComfyUI 的核心代码
  2. 更新 ComfyUI 的核心依赖，包括必要的 Python 依赖和 ComfyUI 的功能依赖包。
核心代码： 新的节点，新的模型支持，新的功能等。 核心依赖： 主要包括 ComfyUI 的前端功能，工作流模板，节点帮助文档等。 
comfyui-frontend-package   # ComfyUI 前端功能
comfyui-workflow-templates # ComfyUI 工作流模板  
comfyui-embedded-docs      # ComfyUI 节点的帮助文档
目前这三个核心依赖项目分别在不同的仓库中维护： 另外很有必要说明的一点是，开发版本(nightly) 和 稳定版本(release) 的区别：
  • 开发版本(nightly)：最新 commit 的代码，你可以体验到我们最新提供的一些功能，但是也有可能存在一些潜在的问题
  • 稳定版本(release)：是基于稳定版本构建，通常会滞后于开发版本，但是稳定性更高，我们会在相关功能发布稳定后对稳定版本进行支持
目前较多用户总是在更新过程中处于 release 版本或者桌面版，但是发现需要的功能是开发版本中提供的对应版本并不存在，对于此情况请检查本地 ComfyUI/requirements.txt 和nightly 版本的依赖是否一致，来确定当前是否所有依赖都是我们最新版本的功能支持。

​
常见更新问题

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

  • 未正确更新依赖
  • 依赖更新失败
经常有用户只是使用 git pull 命令来更新 ComfyUI 的代码，但忽略了核心依赖更新，导致出现以下问题：
  • 前端功能缺失或显示异常
  • 找不到新增的工作流模板
  • 节点帮助文档过时或缺失
  • 新功能没有对应的前端支持
请在使用了 git pull 命令后，在对应的 ComfyUI 环境使用 pip install -r requirements.txt 命令来更新依赖。

​
如何正确更新核心依赖

  • 便携版
  • 手动安装
  • 桌面版
推荐方法：使用 ComfyUI_windows_portable\update\update_comfyui.bat 这个批处理脚本，这个脚本会同时更新 ComfyUI 代码和所有 Python 依赖包。手动更新依赖： 如果你需要手动更新依赖，可以使用以下命令：
# 在便携版目录下打开命令行
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

​
依赖更新故障排除

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

检查网络连接

如果位于中国大陆地区，请确保能够访问 PyPI 或配置中国境内镜像：
# 使用清华大学镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
2

逐个安装核心包

如果批量安装失败，可尝试逐个安装。首先查看 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）版本？

不同版本的区别
  • 开发版本 (nightly)
  • 稳定版本 (release)
  • 特点：包含最新的 commit 代码
  • 优势：可以第一时间体验到最新功能和改进
  • 风险：可能存在未发现的 bug 或不稳定因素
  • 适合人群：开发者、测试用户、想要体验最新功能的用户
  • 便携版
  • 手动安装
  • 桌面版
使用 update_comfyui.bat 而不是 update_comfyui_stable.bat：
# 开发版本（最新功能）
double-click: update_comfyui.bat

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

​
更新后出现错误怎么办？

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

故障排查

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

​
如何了解最新功能？

⌘I