Portable 的 Python 到底是哪一个:安装依赖与启动路径指南
Portable 包含自己的 Python 与 ComfyUI 目录。最容易出错的操作,是把依赖安装到系统 Python,却期待嵌入式 Python 可以自动使用。此文按进程和路径解释如何避免两套环境混用。
用途与适用范围
Portable 包含自己的 Python 与 ComfyUI 目录。最容易出错的操作,是把依赖安装到系统 Python,却期待嵌入式 Python 可以自动使用。此文按进程和路径解释如何避免两套环境混用。
已核对的依据
官方 Portable 文档给出 python_embeded 目录与启动脚本,名称中的 embeded 是实际目录拼写。不同显卡和软件组合可能对应不同发布包,不能把一个启动脚本名字当成全部平台标准。 D06 D08
开始前需要分清的事项
1. 先确定解压位置,避免多个同名包和旧快捷方式同时存在。
2. 检查下载来源以及包所支持的 GPU/平台,不使用来源不明的所谓万能整合包。
3. 模型、用户工作流与配置应有独立备份,不能把删除整个 Portable 当作第一步修复。
操作与检查步骤
以下步骤是基于所列资料编排的操作建议;具体文件、版本和运行环境仍需按实际项目核对。
第 1 步。 从启动日志或进程路径定位正在使用的包,确认真正的 ComfyUI 根目录,而不是浏览器历史里记住的地址。
第 2 步。 安装 Python 依赖时直接调用该包的 python_embeded/python.exe;仓库 requirements 路径也应指向这一实例。
第 3 步。 安装后重启对应后端,检查节点 IMPORT FAILED 与依赖错误是否消失。刷新浏览器不等于重启 Python。
第 4 步。 需要复制或更新包时保留原版本与模型目录映射,先用小工作流回归再替换日常快捷方式。
可复制的检查命令
在 Portable 根目录执行只读检查:
.\python_embeded\python.exe -c "import sys; print(sys.executable); print(sys.version)"
.\python_embeded\python.exe -m pip --version
.\python_embeded\python.exe -m pip check
完成后的检查
启动、安装依赖和诊断命令使用同一个解释器与同一份 ComfyUI,避免“一个终端正常、网页仍然报错”的错位。
注意事项与尚未确认的部分
不要把系统 site-packages 直接复制进嵌入式 Python。不同 Python/平台编译的扩展可能无法工作,甚至造成更难回退的混合状态。
资料核对日期:2026-09-21。本站未执行此工作流,未进行 GPU、最低显存或耗时测试。
原始资料
- D06 · ComfyUI Portable Windows。核对:2026-09-21。
- D08 · Install custom nodes。核对:2026-09-21。
相关排查与操作
这篇内容对你有帮助吗?
匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排;没有执行、硬件测试或保证修复的结论。
01ComfyUI Portable Windows资料核对: 2026-09-2102Install custom nodes资料核对: 2026-09-21报告问题 · f78b966a-6bc7-502d-a749-a449936560d5
相关阅读
编辑为本页关联的条目。
日志关键词: ModuleNotFoundError
适用于启动或执行自定义节点时提示缺少 Python 模块。命令行显示“已安装”仍可能是另一个 Python 的结果;Windows Portable 尤其需要区分系统 Python 与内置解释器。
日志关键词: ComfyUI-Manager
适用于升级后找不到 Manager 按钮,或手动安装后界面没有变化。当前新旧 Manager 界面、Desktop 与手动安装的入口不同,不能照着旧截图判断一定没装好。
多个 ComfyUI 实例可以按支持的配置引用已有模型目录,但共享文件不代表共享了 Python 环境、节点安装和工作流版本。本页重点解决“模型明明在磁盘上,当前实例却找不到”。