跳至正文
ComfyUI WorldBETA
登录
资料整理

Portable 的 Python 到底是哪一个:安装依赖与启动路径指南

Portable 包含自己的 Python 与 ComfyUI 目录。最容易出错的操作,是把依赖安装到系统 Python,却期待嵌入式 Python 可以自动使用。此文按进程和路径解释如何避免两套环境混用。

更新于 2026-09-28发布修订: 7资料基线: 7

用途与适用范围

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、最低显存或耗时测试。

原始资料

相关排查与操作

这篇内容对你有帮助吗?

匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。

资料来源

基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排;没有执行、硬件测试或保证修复的结论。

01ComfyUI Portable Windows资料核对: 2026-09-2102Install custom nodes资料核对: 2026-09-21

报告问题 · f78b966a-6bc7-502d-a749-a449936560d5

继续探索

编辑为本页关联的条目。

问题排查约 2 分钟阅读
ModuleNotFoundError:包已安装,ComfyUI 仍说找不到模块

日志关键词: ModuleNotFoundError

适用于启动或执行自定义节点时提示缺少 Python 模块。命令行显示“已安装”仍可能是另一个 Python 的结果;Windows Portable 尤其需要区分系统 Python 与内置解释器。