No module named xxx 解决：Python 依赖缺失排查
修复 ComfyUI No module named 报错，说明如何进入对应 custom_nodes 目录安装 requirements，并区分 Python 环境和依赖版本问题。
一句话结论
能找到缺依赖的插件目录，并把依赖装进正确 Python 环境。
这篇解决什么问题
No module named xxx 表示 Python 找不到依赖包。通常发生在自定义节点加载时，不代表模型坏了。它也经常和“装到了错误的 Python 环境”一起出现，所以先分清是缺包还是装错环境。
如果你是第一次接触 ComfyUI，建议不要跳步。先把最小流程跑通，再安装插件、导入复杂工作流或追求高分辨率。ComfyUI 的大多数问题都可以通过“看控制台日志、确认目录、确认版本、降低参数”这四件事定位。
适合谁
- 刚开始使用 ComfyUI，需要一篇可以照着做的教程。
- 已经遇到相关报错，但不知道该先检查哪一步。
- 想把安装、模型、插件、工作流整理成可复查流程的用户。
准备条件
- 保留完整控制台报错。
- 知道自己用便携版还是系统 Python。
这类报错的关键不是网页提示，而是控制台最后几行。先找缺哪个模块，再从路径判断是哪个 custom_nodes 插件缺依赖。
上图把 No module named 的处理顺序压缩成一条最短路径：先记模块名，再找插件目录，再装依赖，最后重启。不要只在网页上看红字。
这张图专门提醒便携版用户：先确认是不是在 ComfyUI 自带的 Python 环境里装包，而不是把依赖装到了系统 Python。
操作步骤
- 看 Traceback 最后几行，记录缺失模块名。
- 往上看路径，找到是哪个 custom_nodes 插件报错。
- 如果插件目录有 requirements.txt，优先安装它。
- 便携版要使用 python_embeded/python.exe 执行 pip，避免装到系统 Python。
- 安装完成后重启 ComfyUI。
- 如果仍失败，检查插件 README 是否有额外安装步骤。
- 如果报错模块来自多个插件，先停掉最可疑的那个，别同时改太多处。
便携版和系统安装的区别
- 便携版：尽量用 ComfyUI 自带的 Python。
- 系统安装：确认你装包的 Python 跟启动 ComfyUI 的 Python 是同一个。
- 不确定时，先在启动脚本附近找
python.exe的真实路径。
判断问题属于哪一类
- 如果页面打不开，先看启动窗口是否还在运行，以及端口是否正确。
- 如果节点是红色，优先处理缺失自定义节点或插件加载失败。
- 如果模型下拉框为空，优先检查模型类型和放置目录。
- 如果开始生成后失败，优先看显存、模型版本和具体报错节点。
- 如果更新后才坏，优先考虑插件版本不兼容，必要时回退或临时移除插件。
常见错误
- 直接 pip install 到系统 Python，ComfyUI 仍然找不到。
- 只安装缺失模块名，漏掉 requirements 里的其他依赖。
- 忽略 Python 版本不兼容。
- 先升级大环境，再回头找不到到底是谁坏了。
如果还是失败
如果缺的是 torch、opencv-python、numpy 这类基础包，先看是不是插件要求特定版本。遇到版本冲突时，通常不是“再装一次”能解决，而是要让插件、ComfyUI、Python 版本对齐。
验证是否成功
- 启动时不再出现该模块缺失。
- 对应自定义节点能正常显示。
如果仍然失败
请把控制台里从 Traceback 开始到最后一行的完整报错保存下来，同时记录：ComfyUI 版本、启动方式、显卡型号、显存容量、使用的模型文件名、刚安装过哪些插件。不要只截网页上的红色提示，因为真正有用的信息通常在启动窗口里。
如果你在本站提交反馈，登录状态下会自动附带 user_id，方便后续追踪同一个用户遇到的连续问题；未登录也可以匿名提交。
下一步推荐
- 新手路线：/topics/comfyui-beginner/
- 报错排查：/topics/comfyui-errors/
- 模型基础：/topics/model-basics/
- 插件安装：/topics/must-have-plugins/
更新记录
- 2026-05-12：扩写为正式教程，补充操作步骤、常见错误和验证清单。