更新与回滚 ComfyUI：先保存哪些文件和版本
本指南用于在更新前建立恢复条件。能够 git checkout 旧代码，不等于 Python 依赖、前端、节点和配置也恢复到了旧状态；真正可回退需要记录整个环境的关键组成。
用途与适用范围
本指南用于在更新前建立恢复条件。能够 git checkout 旧代码，不等于 Python 依赖、前端、节点和配置也恢复到了旧状态；真正可回退需要记录整个环境的关键组成。
已核对的依据
官方更新说明按安装方式区分核心与相关依赖，节点排错也涉及更新后的冲突。pip check 能暴露声明冲突，但无法恢复此前的包或保证二进制兼容。 D07 D02 P08
开始前需要分清的事项
1. 备份用户工作流、配置、额外模型路径映射及需要保留的输出。
2. 记录核心、前端、模板、节点与 Python/Torch 版本及安装方式。
3. 区分可重新下载的模型与用户独有数据，避免不必要复制超大权重。
操作与检查步骤
以下步骤是基于所列资料编排的操作建议；具体文件、版本和运行环境仍需按实际项目核对。
第 1 步。 在更新前运行一个已知正常的小工作流，保存输入、结果与环境清单作为基线。
第 2 步。 优先在安装副本或新环境执行更新，读取变更说明，避免同时引入多种新扩展。
第 3 步。 逐层检查启动、节点注册、模型加载和基线工作流；失败时比较这次具体改动，不继续连续升级直到错误变样。
第 4 步。 恢复时同时处理代码、依赖、前端和节点版本，按备份策略还原；确认恢复后的实际进程路径与原基线一致。
可复制的检查命令
在当前环境保存只读版本快照，输出文件应妥善保管：
python -m pip freeze > environment-before-update.txt
python -m pip check
公开分享前检查快照是否含私有仓库地址或路径。
完成后的检查
能够明确说出这次改了什么、基线是否通过以及如何恢复；仅恢复页面显示不足以证明所有工作流兼容。
注意事项与尚未确认的部分
不要未经确认执行 git reset --hard、删除虚拟环境或覆盖用户目录。pip freeze 记录版本但不保证所有平台未来都能下载对应构建。
资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。
原始资料
- D07 · How to update ComfyUI。核对：2026-09-21。
- D02 · ComfyUI custom node troubleshooting。核对：2026-09-21。
- P08 · pip check。核对：2026-09-21。
相关排查与操作
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排；没有执行、硬件测试或保证修复的结论。
01How to update ComfyUI资料核对: 2026-09-2102ComfyUI custom node troubleshooting资料核对: 2026-09-2103pip check资料核对: 2026-09-21报告问题 · 9e103f33-967c-517c-86dc-0b9b6cfdf287
相关阅读
编辑为本页关联的条目。
日志关键词: workflow templates
更新之后，新教程里的模板或界面仍然不存在。ComfyUI 核心源码、桌面应用、前端包、自定义节点与模板并不是一个不可分割的版本号。
日志关键词: ImportError: cannot import name
适用于升级后某个节点导入失败，或提示某模块缺少过去使用的名称、属性。它与 No module named 不同：模块可能已经存在，只是调用的接口或导入关系不再满足要求。
日志关键词: _ARRAY_API not found
适用于安装或更新节点后，导入 NumPy 相关扩展时出现 ABI 报错。问题通常发生在编译扩展与 NumPy 的二进制接口之间，而不是工作流连线本身。