更新 ComfyUI 时，出错的主要原因往往不是命令本身复杂，而是把 Portable、Comfy Desktop 和手动 Git 安装当成了同一种东西。

请先确认自己使用的是哪个版本，再选择对应的更新路径：

• Windows Portable：运行安装目录里的批处理脚本。
• Windows 或 macOS 的 Comfy Desktop：使用内置更新功能。
• 手动 Git 安装：需要执行 git pull 和依赖更新。

更新完成后，应能正常启动原有工作流，且自定义节点没有新增报错。

动手前，先确认安装方式和版本目标

确认安装方式：

• 如果安装目录里有 ComfyUI_windows_portable 和 update 文件夹，属于 Windows Portable。
• 如果能从应用菜单打开 Desktop Settings，属于 Comfy Desktop。
• 如果最初通过 git clone 获取代码，并由自己维护 Conda 或 venv 环境，则属于 手动 Git 安装。

注意：三条路径不要交叉执行。

选择版本目标：

• Development 或 nightly：跟随较新的开发提交，功能到得快，但更可能遇到兼容问题。
• Stable 或 release：以经过测试的版本为主，功能可能晚一些。

Comfy Desktop 通常基于稳定版。不要将“Desktop 已是最新版”等同于“已经拥有开发版的最新功能”。

升级前准备：

• 关闭正在运行的 ComfyUI。
• 备份 custom_nodes、重要工作流、模型路径配置和当前可用的 Python 环境信息。
• 如果某个生产工作流必须稳定运行，先保留整个可用安装副本，再更新副本。

Windows Portable：从 update 文件夹选择正确脚本

1. 先备份现有 Portable 目录

• 入口位置：打开保存 ComfyUI_windows_portable 的上一级文件夹。
• 主要动作：复制整个 ComfyUI_windows_portable 文件夹，或至少备份 ComfyUI/custom_nodes、工作流和手动安装的软件包版本记录。
• 成功标志：备份副本能独立找到，文件数量和原目录一致，关键工作流 JSON 已包含在内。
• 失败处理：磁盘空间不足时，先把工作流、自定义节点和环境记录备份到其他磁盘。没有可恢复副本时，不要运行依赖重装脚本。

2. 运行与目标版本对应的更新脚本

• 入口位置：进入 ComfyUI_windows_portable/update 文件夹。
• 主要动作：需要开发版时双击 update_comfyui.bat；需要稳定版时双击 update_comfyui_stable.bat。不要把 update_comfyui_and_python_dependencies.bat 当作普通更新按钮。
• 成功标志：更新窗口完成代码拉取且没有错误中断，重新启动 Portable 后能进入原有界面。
• 失败处理：窗口提示网络、Git 或文件占用错误时，保持现有目录不动，确认 ComfyUI 已退出并恢复网络后再处理。不要连续运行三个脚本碰运气。

3. 只在确有依赖问题时重装 Python 依赖

• 入口位置：仍在 ComfyUI_windows_portable/update 文件夹，找到 update_comfyui_and_python_dependencies.bat。
• 主要动作：仅在依赖损坏、跨越较大版本或普通更新无法修复时运行该脚本。它会更新 ComfyUI、更新面向 NVIDIA GPU 的 PyTorch，并重新安装全部 Python 依赖。
• 成功标志：依赖安装完整结束，ComfyUI 能启动，常用自定义节点能够加载。
• 失败处理：若自定义节点出现包版本冲突，停止继续覆盖，回到备份副本，对照更新前的软件包记录逐项恢复。无法确认冲突来源时，先保留失败日志。

Comfy Desktop：让应用自己处理核心和依赖

Desktop 路径适用于 Windows 和 macOS。它会一起处理 ComfyUI 核心代码与依赖，通常不需要在应用目录里手动运行 git pull。先从设置入口检查更新配置。

1. 打开 Desktop Settings

• 入口位置：Comfy Desktop 主窗口左上角的三横线菜单。
• 主要动作：点击菜单，再选择 Desktop Settings。
• 成功标志：窗口进入带有侧边栏的 Desktop Settings 页面。
• 失败处理：菜单里没有该项时，先确认打开的是 Comfy Desktop 外壳，而不是浏览器中的 ComfyUI 页面。也可使用 Ctrl+, 或 Cmd+, 打开设置。

2. 启用自动安装 Desktop 更新

• 入口位置：Desktop Settings 的更新设置区域。
• 主要动作：打开 Automatically install Desktop updates 开关。
• 成功标志：开关显示为启用状态，应用随后可在后台下载并安装 Desktop 更新。
• 失败处理：开关无法改变时，退出并重新打开 Desktop。若设备由组织策略管理，先确认当前账户是否允许应用自更新。

3. 需要立即更新时手动检查一次

• 入口位置：Comfy Desktop 顶部菜单中的 Menu，再进入 Help。
• 主要动作：点击 Check for Updates。
• 成功标志：应用开始检查，并在有新版本时给出下载或安装入口。
• 失败处理：点击后长期没有状态变化时，先检查网络，再到 Desktop Settings 的 Updates 页查看最近检查时间。不要同时启动第二个 Desktop 实例。

4. 下载更新并让 Desktop 重启应用

• 入口位置：Desktop Settings 左侧的 Updates 页。
• 主要动作：先点 Check for updates；检测到新版本后，按页面状态完成 Download、Install，或点击出现的 Restart & Update。
• 成功标志：Desktop 完成重启，Updates 页不再显示待安装版本。
• 失败处理：下载或安装中断时，不要强制删除应用数据，先重新打开 Updates 页再检查。反复失败时，保留当前可用实例并查看应用日志。

5. 核对 Desktop 已到当前稳定版本

• 入口位置：重启后重新打开 Desktop Settings 的 Updates 页。
• 主要动作：查看状态、安装版本和最近检查时间。
• 成功标志：页面显示 Comfy Desktop is up to date，并列出当前版本与最近检查时间。
• 失败处理：如果状态仍提示待更新，先完成页面上的下载或安装动作。如果已是最新版却没有某个开发版功能，原因可能是 Desktop 采用稳定版本，而不是更新失败。

手动 Git 安装：代码和 requirements.txt 要一起更新

手动路径适用于 Windows、macOS 和 Linux。前提是现有目录最初由 Git 克隆，并且你知道它正在使用哪个 Conda 或 venv 环境。

只执行 git pull 会更新核心代码，却可能留下旧的前端包、工作流模板、节点帮助文档和其他核心依赖。

1. 激活现有 ComfyUI Python 环境

• 入口位置：打开终端或命令提示符，进入平时启动 ComfyUI 所用的环境。
• 主要动作：Conda 环境运行 conda activate comfyui；Windows venv 运行 venvScriptsactivate；macOS 或 Linux venv 运行 source venv/bin/activate。
• 成功标志：命令行提示符显示目标环境名称，随后运行的 python 和 pip 都来自该环境。
• 失败处理：路径不存在时，不要改用系统 Python，先找到原安装使用的环境目录。环境已经损坏时，保留旧目录，另建环境后再验证依赖。

2. 拉取当前分支的最新代码

• 入口位置：终端中进入包含 ComfyUI 仓库的目录。
• 主要动作：执行 cd ，再运行 git pull。
• 成功标志：Git 显示“已更新”或“已经是最新”，没有未解决的合并冲突。
• 失败处理：出现本地修改冲突时，先用 git status 查明文件，不要直接覆盖。把需要保留的修改单独备份或提交后再继续。

3. 按同一份代码的 requirements.txt 更新依赖

• 入口位置：仍在 ComfyUI 仓库根目录，并保持目标虚拟环境处于激活状态。
• 主要动作：运行 pip install -r requirements.txt。
• 成功标志：依赖解析和安装结束，没有包安装失败。前端、工作流模板、节点文档及核心工具包与当前代码要求一致。
• 失败处理：先记录报错包名并确认网络和目录权限，再按当前 requirements.txt 的版本要求重试。不要脱离该文件把所有包单独升级到最新版，否则会制造新的版本冲突。

4. 重启 ComfyUI 并读取启动日志

• 入口位置：同一虚拟环境和 ComfyUI 根目录。
• 主要动作：运行 python main.py。
• 成功标志：后端正常启动，浏览器界面可打开，原有工作流能加载，常用自定义节点没有新增导入错误。
• 失败处理：若日志出现 Falling back to the default frontend. 或前端版本异常，重新检查依赖安装结果。若只在某个自定义节点加载时失败，先停用该节点并查看它对包版本的要求。

升级后出现异常时，先分清代码、依赖和节点问题

如果界面缺少新功能、找不到新模板或节点帮助仍是旧版，通常先检查是否只更新了 Git 代码而没有更新依赖。重新激活正确环境并执行 pip install -r requirements.txt，比盲目重装整个系统更直接。

依赖安装失败时，启动日志可能显示“回退到默认前端”。保留完整日志，核对失败包是否满足当前仓库 requirements.txt，再检查网络和写入权限。手动安装中用错 Python 环境，也会造成“安装成功但启动仍报旧版本”的假象。

更新后只有自定义节点报错，先把问题限定到该节点：查看节点项目声明的兼容版本，临时移出该节点后重新启动。生产任务急用时，恢复更新前备份比继续叠加不同版本的软件包更稳妥。

完成检查清单

• 已经确认安装方式，没有把 Portable、Desktop 和手动 Git 路径混用。
• 更新前已备份自定义节点、关键工作流、模型路径配置和可用环境信息。
• Portable 只运行了与目标版本对应的脚本；依赖重装脚本仅在确有需要时使用。
• Desktop 的 Updates 页能显示当前状态、版本和最近检查时间；需要稳定版最新功能时状态为 up to date。
• 手动安装在正确虚拟环境中完成了 git pull 与 pip install -r requirements.txt。
• ComfyUI 能重新启动，原有工作流可打开，常用自定义节点没有新增报错。
• 若出现异常，已保留启动日志，并能判断问题属于代码、依赖还是某个自定义节点。

官方资料

• ComfyUI 官方更新指南
• Comfy Desktop 官方设置说明