如何在Windows上迁移ComfyUI

Windows 上迁移 ComfyUI 的实用方案
一 迁移方式总览与选择

• 独立便携版迁移：直接拷贝整个 ComfyUI 目录到新机器，适合保留原有虚拟环境与依赖，迁移最快。要求操作系统一致（均为 Windows 10/11 64 位）、Python 主次版本完全一致（如都为 3.11.11），最好项目路径一致；GPU 迁移需保持同架构显卡与相同 CUDA 版本。满足这些条件时，仅需修正虚拟环境路径即可复用。
• 桌面版迁移：使用官方 ComfyUI Desktop 安装包在新机安装，安装向导支持关联已有模型目录、迁移用户设置；自定义节点需重新安装，模型默认不复制，仅建立关联。适合希望“装即用”的用户。
• 路径映射迁移：不移动大体积模型，通过 extra_model_paths.yaml 或 mklink 目录联接把模型、工作流等指向原有位置，最省磁盘与时间，适合多版本或多盘位共用模型库。

二 独立便携版迁移步骤（最快，适合同配置）

• 前置检查
• 确认源/目标均为 Windows 64 位，且 Python 版本一字不差（示例：都为 3.11.11）。
• GPU 使用 CUDA 时，目标机保持同架构 NVIDIA 显卡与相同 CUDA 驱动/工具包版本。
• 建议目标机保持与源机相同的项目路径（如都为 F:PythonProjectsComfyUI）。
• 执行迁移

1) 将源机的整个 ComfyUI 文件夹复制到目标机（同路径最佳）。
2) 若路径发生变化，打开 .venvpyvenv.cfg，修正以下关键项，使其指向目标机的 Python：

• base-executable：目标机 python.exe 的完整路径
• base-prefix / base-interpreter：目标机 Python 安装前缀

3) 进入 ComfyUI 目录，激活环境并校验依赖：

• 运行：.venvScriptsactivate（PowerShell 可用：..venvScriptsActivate.ps1）
• 如有 requirements.txt，执行：.venvScriptspip install -r requirements.txt

4) 启动服务：双击 run_nvidia_gpu.bat 或 python main.py，访问 http://127.0.0.1:8188 验证。

• 常见报错速解
• 激活提示找不到 python.exe：检查 pyvenv.cfg 中 base-executable 路径是否准确。
• ModuleNotFoundError：执行一次 requirements.txt 重装依赖。
• GPU 加速失效：核对 CUDA 驱动/工具包版本与目标机显卡架构是否匹配。

三 桌面版迁移步骤（装即用，适合重装或跨盘）

• 安装与导入

1) 在目标机安装 ComfyUI Desktop（Windows 安装包）。安装路径避免中文字符，预留≥15GB空间（模型另计）。
2) 安装向导的“文件迁移”步骤可选择已有 ComfyUI 目录进行关联：

• Models 模型：默认不复制，建立与原位置的关联；
• User Files 用户文件：可迁移；
• Custom Nodes 自定义节点：需重新安装（桌面版当前不支持一键导入节点）。

3) 完成后首次启动会自动部署/检查环境，随后在 http://127.0.0.1:8188 使用。

• 后续维护
• 右上角“底部面板”可查看日志与下载进度；左上角 Help → Open Folder 可快速打开 models、outputs、custom_nodes 等目录。
• 版本更新可在界面提示或设置中自动/手动进行。

四 路径映射迁移（不改目录，最省事）

• 使用 extra_model_paths.yaml 集中映射

1) 在 ComfyUI 根目录创建或编辑 extra_model_paths.yaml，用 绝对路径映射模型子目录（YAML 对缩进与冒号空格敏感）：

• 示例（按需增减子目录）：
• base_path: C:DesignSoftwareComfyUI_Library
• checkpoints: modelscheckpoints
• loras: modelsloras
• upscale_models: modelsupscale_models
• custom_nodes: C:DesignSoftwareComfyUI_Librarycustom_nodes

2) 如需与 WebUI 共用模型库，可参考官方模板并按实际盘符调整。

• 使用 mklink 目录联接（适合工作流与模型库共享）
• 将工作流目录联接至统一库：
• mklink /J "C:DesignSoftwareComfyUI_Officeuserdefaultworkflows" "C:DesignSoftwareComfyUI_Libraryworkflows"
• 将模型目录联接至统一库（示例）：
• mklink /J "C:DesignSoftwareComfyUI_Officemodelscheckpoints" "C:DesignSoftwareComfyUI_Librarymodelscheckpoints"
• 提示：联接前先备份原文件夹，联接时删除原文件夹再执行命令。
• 版本更新提示
• 升级后若出现配置项变化，先备份 extra_model_paths.yaml，再用 extra_model_paths.yaml.example 作为模板合并更新。

五 迁移后的验证与常见问题

• 验证清单
• 浏览器可打开 http://127.0.0.1:8188 且界面加载正常；
• 已安装节点可见、工作流可运行；
• 模型路径正确，无“缺失模型”提示；
• 若使用 ComfyUI-Manager：打开 Manager → Snapshots → Import 导入迁移前快照，或复制 ComfyUI-Manager 用户目录到新环境 /default/ 下并重启恢复。
• 常见问题速解
• 路径相关报错：检查 extra_model_paths.yaml 与 pyvenv.cfg 中的绝对路径是否全部更新；
• 节点缺失：使用 Manager 的 Install Missing Custom Nodes 或重新安装；
• 配置文件冲突：保留新环境默认配置，手动合并新增项；
• 桌面版自定义节点未生效：桌面版需重新安装节点，模型默认仅关联不复制。