ModuleNotFoundError：包已安装，ComfyUI 仍说找不到模块

现象与适用范围

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

检索用原文或片段（具体编号、数值和文件名随环境变化）：

ModuleNotFoundError
No module named

已核对的依据

Portable 自带 python_embeded；官方明确要求向运行它的解释器安装节点依赖。pip check 只能检查已安装分发包声明的依赖，不能证明目标模块可正常导入。 D02 D06 P08

需要区分的情况

1. 安装到了另一个虚拟环境或系统 Python。

2. 项目代码已下载，但 requirements 中的依赖未成功装完。

3. Python import 名称与 PyPI 分发包名不同，按报错文字直接 pip install 猜错了包。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 保留完整 traceback，定位第一次进入哪个 custom_nodes 项目。到该仓库 README/requirements 查询真正需要的分发包。

第 2 步。 用启动日志里的 Python 路径执行 -m pip --version，确认 pip 安装目录与当前实例一致。

第 3 步。 先阅读依赖列表，再按作者支持的版本安装；命令失败时处理安装错误，不把下载开始视为安装完成。

第 4 步。 单独检查目标模块导入，之后重启 ComfyUI。若转成 DLL/ABI 错误，转入二进制兼容排查，不继续反复装同一包。

可复制的检查命令

在 Windows Portable 根目录执行只读检查：

.\python_embeded\python.exe -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -m pip --version
.\python_embeded\python.exe -m pip check

如何判断处理有效

同一个解释器可以 import 目标模块，启动日志中该节点包不再失败，后端能识别类名。记录实际安装版本，方便下一次升级回查。

注意事项与尚未确认的部分

不要执行来历不明的“缺模块一键全装脚本”。节点会运行 Python 代码；读取用户工作流不构成安装任意依赖的安全依据。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D02 · ComfyUI custom node troubleshooting。核对：2026-09-21。
• D06 · ComfyUI Portable Windows。核对：2026-09-21。
• P08 · pip check。核对：2026-09-21。

相关排查与操作

• DLL load failed：定位原生扩展，不要下载散装 DLL 覆盖系统
• pip ResolutionImpossible：两个节点的依赖冲突怎么处理