ComfyPilotComfyPilot
文档 / 安装 / 如何更新 ComfyUI

如何更新 ComfyUI

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

安装 update_comfyui 更新于 2026-11-09

查看官方原文

如何更新 ComfyUI

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

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

如何更新 ComfyUI?

[tab] 便携版 ComfyUI 便携版提供了便捷的批处理脚本来完成更新操作。 ### 更新脚本位置 在便携版安装目录下的 update 文件夹中，可以找到以下更新脚本： `` ComfyUI_windows_portable └─ 📂update ├── update.py ├── update_comfyui.bat // 更新到最新开发版本 ├── update_comfyui_stable.bat // 更新到最新稳定版本 └── update_comfyui_and_python_dependencies.bat // ⚠️ 危险：重装依赖 - 可能导致冲突 ` > [!WARNING] > > 更新过程中请保持网络连接稳定，如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库 > [!WARNING] > > **⚠️ 危险：请谨慎使用 update_comfyui_and_python_dependencies.bat！** > > 这个脚本比普通更新更彻底，它会： > > * ✅ 更新 ComfyUI 代码本身 > * ✅ 为**标准 Nvidia 便携包**更新 PyTorch（当前为 **CUDA 13.0 / cu130**，Python 3.13） > * ✅ 重新安装所有 Python 依赖包 > > **旧版 Nvidia 便携包（CUDA 12.6 / cu126）：** 若你安装的是面向 Nvidia **10 系及更早 GPU** 的单独便携包，该版本使用 **CUDA 12.6** 与 Python 3.12。请勿把 cu130 当作该包的正确目标——请用与该便携包匹配的 cu126 wheel 源重装或更新 PyTorch，或从 [Portable 安装指南](https://docs.comfy.org/zh/installation/comfyui_portable_windows.md) 重新下载 cu126 包。 > > **风险提示：** > > * 可能与现有配置产生依赖冲突 > * 可能破坏依赖特定包版本的自定义节点 > * 可能覆盖手动配置的包版本 > * 在 cu126（或其他非 cu130）便携包上强行安装 cu130 wheel 可能导致 GPU 无法启动 > > **⚠️ 仅在以下情况使用此脚本：** > > * 需要修复依赖问题时 > * 进行大版本更新时 > * 日常更新建议使用 update_comfyui.bat` > > 运行此脚本前必须： > > 1. 备份整个 ComfyUI 安装目录 > 2. 记录已安装的自定义包版本 > 3. 确认你使用的是哪种便携包（cu130 标准版 vs cu126 旧版）——参见 Windows 版 ComfyUI Portable > 4. 做好重新安装自定义节点的准备
[tab] 桌面版 要更新 ComfyUI，请打开 管理面板 的更新标签页。你可以在 稳定版（默认）和 GitHub 最新版 更新频道之间选择。 桌面版客户端本身的更新是自动的，与 ComfyUI 实例更新相互独立。
[tab] 手动安装 手动安装的 ComfyUI 需要通过 Git 命令来完成更新操作。 ### 更新前准备 确保你的系统已安装 Git 并且 ComfyUI 是通过 Git 克隆安装的。 ### 更新步骤 1. 激活虚拟环境 首先激活 ComfyUI 的 Python 虚拟环境（如果使用了虚拟环境）： ``bash theme={null} # 对于 conda 环境 conda activate comfyui # 对于 venv 环境 # Windows venv\Scripts\activate # macOS/Linux source venv/bin/activate ` **2. 拉取最新代码** 进入 ComfyUI 安装目录并拉取最新代码： `bash theme={null} cd <ComfyUI安装路径> git pull ` **3. 更新依赖** 安装或更新 ComfyUI 的依赖包： `bash theme={null} pip install -r requirements.txt ` > [!WARNING] > > 请确保当前处于 ComfyUI 的虚拟环境中，避免污染系统级 Python 环境 **4. 重启 ComfyUI** 更新完成后重新启动 ComfyUI： `bash theme={null} python main.py ` ### 切换版本（可选） 如果需要切换到特定版本，可以使用以下命令： `bash theme={null} # 查看提交历史 git log --oneline # 切换到特定提交 git checkout <commit-hash> # 返回最新版本 git checkout master `` > [!TIP] > > 建议定期更新以获得最新功能和安全修复，同时推荐使用稳定版本以确保系统稳定性

ComfyUI 的不同版本说明

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

[accordion] Comfy 桌面版 Comfy Desktop 支持在 Windows、macOS（Apple Silicon） 和 Linux（AppImage 和 .deb）上进行独立安装。 * 源码在 GitHub > [!TIP] > > Desktop 安装默认跟踪 ComfyUI 的 稳定版。如果想始终使用最新提交，请使用便携版或手动 git 安装，或把实例更新通道改为 Latest on GitHub。 你可以从下面选择适合你的系统和硬件开始安装 > [tab] Windows > > > [card] Comfy Desktop（Windows）安装指南 > > > > 适用于 Windows 10 或更高版本。推荐 NVIDIA 或 AMD 显卡。 > [tab] macOS (Apple Silicon) > > > [card] Comfy Desktop（macOS）安装指南 > > > > 适用于带有 Apple Silicon 的 macOS > [tab] Linux > > > [card] Comfy Desktop（Linux）安装指南 > > > > 安装 AppImage 或 .deb，或从源码构建并运行。
[accordion] ComfyUI 便携版（Windows） 便携版是集成了独立嵌入式 Python 环境的 ComfyUI 版本，使用便携版可以体验最新功能，目前仅支持 Windows 系统 > [card] ComfyUI 便携版（Windows）安装指南 > > 支持在 Nvidia GPU 或 仅 CPU 上运行的 Windows ComfyUI 版本，始终使用最新提交，完全便携。
[accordion] 手动安装 > [card] ComfyUI 手动安装指南 > > 支持所有系统类型和 GPU 类型（Nvidia、AMD、Intel、Apple Silicon、Ascend NPU、Cambricon MLU）

在更新 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 核心工具库

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

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

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

目前较多用户总是在更新过程中处于 release 版本，或桌面版默认的 稳定版 频道，但发现需要的功能只在开发 / nightly 构建中提供。桌面版 可在 管理 → 更新 切换到 GitHub 最新版。便携版或手动安装请检查本地 ComfyUI/requirements.txt 和nightly 版本的依赖是否一致，来确定当前是否所有依赖都是支持最新功能的。

常见更新问题

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

[tab] 未正确更新依赖 经常有用户只是使用 git pull 命令来更新 ComfyUI 的代码，但忽略了核心依赖更新，导致出现以下问题： 前端功能缺失或显示异常 找不到新增的工作流模板 节点帮助文档过时或缺失 新功能没有对应的前端支持 请在使用了 git pull 命令后，在对应的 ComfyUI 环境使用 pip install -r requirements.txt 命令来更新依赖。
[tab] 依赖更新失败 如果依赖更新失败常见可能是网络或者计算机权限问题，目前在更新过程中如果出现了核心依赖失败的情况会回退到旧版本，通常你可以在启动日志中看到类似下面的日志： `` Falling back to the default frontend. ComfyUI frontend version: xxx ` 请按以下步骤排查： 1. 在对应的环境中使用 pip list 命令来查看当前安装的依赖包，如果发现有版本不一致的情况，请在对应的 ComfyUI 环境使用 pip install -r requirements.txt` 命令来尝试再次更新依赖。 2. 如果更新后仍然存在问题，请检查网络连接是否正常，如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库。 3. 如果仍然存在问题，请检查计算机权限是否正常，如果需要管理员权限，请使用管理员权限运行命令行。

如何正确更新核心依赖

[tab] 便携版 推荐方法：使用 ComfyUI_windows_portable\update\update_comfyui.bat 这个批处理脚本，这个脚本会同时更新 ComfyUI 代码和所有 Python 依赖包。 手动更新依赖： 如果你需要手动更新依赖，可以使用以下命令： ``bash theme={null} # 在便携版目录下打开命令行 .\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt ``
[tab] 手动安装 标准更新流程： 1. 激活虚拟环境 如你使用 Conda 管理虚拟环境，请先激活虚拟环境： ``bash theme={null} conda activate comfyui # 或其他环境名 ` **2. 更新代码** 这一步我们需要进入 ComfyUI 的根目录，并使用 Git 更新对应的代码。 ` cd <ComfyUI根目录> git pull ` **3. 更新依赖** 这一步我们需要更新 ComfyUI 的依赖，这个步骤非常重要，特别是前端 comfyui-frontend-package 的更新 ` pip install -r requirements.txt ``
[tab] 桌面版 ComfyUI 实例 + Python 依赖： 使用 管理 → 更新（稳定版 或 GitHub 最新版）。依赖更新通常会在该流程中一并完成。 桌面应用本身： 使用应用菜单中的 检查更新（与 ComfyUI 更新频道相互独立）。 * 仅在万不得已时重新安装桌面版。

依赖更新故障排除

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

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>
[!WARNING] 建议使用 ComfyUI/requirements.txt 中指定的确切版本号，不要自行升级到最新版本，这可能导致兼容性问题。

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

这是最常见的问题之一：

  • 如果你使用的是桌面版，并且更新频道是 稳定版，功能可能会落后于更新的 GitHub 提交。需要更新功能时，可在 管理 → 更新 标签页把频道切换到 GitHub 最新版（最新版可能更不稳定）
  • 便携版或手动安装若需要最新提交，请确认使用的是开发版本(nightly)，而不是稳定版本(release)

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

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

不同版本的区别

[tab] 开发版本 (nightly) 特点：包含最新的 commit 代码 优势：可以第一时间体验到最新功能和改进 风险：可能存在未发现的 bug 或不稳定因素 适合人群：开发者、测试用户、想要体验最新功能的用户
[tab] 稳定版本 (release) 特点：经过测试和验证的稳定代码 优势：稳定性高，适合生产环境使用 劣势：功能更新会有延迟，可能落后开发版本数周或数月 适合人群：需要稳定性的用户、生产环境用户
[tab] 便携版 使用 update_comfyui.bat 而不是 update_comfyui_stable.bat： `` # 开发版本（最新功能） double-click: update_comfyui.bat # 稳定版本 double-click: update_comfyui_stable.bat ``
[tab] 手动安装 ``bash theme={null} # 切换到开发版本 git checkout master git pull # 切换到最新稳定版本 git fetch --tags git checkout $(git describe --tags git rev-list --tags --max-count=1) ``
[tab] 桌面版 打开 管理面板 的更新标签页即可切换频道： 稳定版（默认）：经过测试的发布版，可能落后于更新的 GitHub 提交 GitHub 最新版：跟踪 GitHub 上的更新提交，可能更不稳定 根据所选频道是否有更新可用，使用 切换频道、立即更新 或 复制并更新。详情见 管理面板更新选项卡。

更新后出现错误怎么办？

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

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

[card] 故障排查 查看如何进行 ComfyUI 的故障排查

如何了解最新功能？