尽管我们可能已经在不同版本的各部分章节，对于 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 时都需要更新什么内容？

目前 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）版本？

不同版本的区别
  • 特点：包含最新的 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 的故障排查

​
如何了解最新功能？