修复 ComfyUI 中的 No module named 错误

如果 ComfyUI 打印出 ModuleNotFoundError: No module named ...，本页是一个导航枢纽，而非某个确切包名的最佳搜索落地页。如果你已经知道缺失的模块名称，请直接跳转到下方的专项修复页面。

缺失的 Python 包只是诊断的一部分。更重要的问题是哪个 Python 环境启动了 ComfyUI。

对于官方 Windows 便携包，包命令通常需要通过以下方式运行：

.\python_embeded\python.exe -s -m pip ...

对于手动 Git 安装，请激活启动 ComfyUI 所使用的同一虚拟环境，然后使用：

python -m pip ...

快速诊断

我们最常见到的缺失模块

下面这些缺失模块最容易在 ComfyUI 启动、插件导入和工作流运行时反复出现。先按模块名分流到对应页面，再确认它是核心依赖、插件依赖，还是可选加速后端。

低频模块：通过插件修复，而非新建文章

部分模块虽然也会反复出现，但优先通过插件或 requirements 文件处理更稳妥：

如果这些模块中的某个受影响安装数增长或获得搜索展示，它可能成为一篇专项指南。在此之前，更安全的公开解答是修复导入它的自定义节点。

如果你已经知道确切的缺失名称，请直接跳转到对应页面，而不是猜测或安装大量依赖包。

No OpenGL_accelerate module loaded 通常不是 ComfyUI 启动失败

你可能在启动时看到这一行：

No OpenGL_accelerate module loaded: No module named 'OpenGL_accelerate'

这不同于 OpenGL dependencies not available 错误。OpenGL_accelerate 由 PyOpenGL-accelerate 提供，是 PyOpenGL 的一个可选 Cython 性能伴侣包。它可以加快 PyOpenGL 的操作速度，但 PyOpenGL 的运行并不依赖它。

如果同一日志后续同时显示 Starting server 和 To see the GUI go to: http://127.0.0.1:...，则 ComfyUI 已成功启动。在这种情况下，不要仅为消除此警告而安装包。

何时需要进行调查

仅当某个具体功能或节点同时出现故障时才进行调查，例如出现报错信息、Cannot import 提示或某个基于 OpenGL 的功能损坏。首先检查启动 ComfyUI 所使用的确切 Python：

.\python_embeded\python.exe -s -m pip show PyOpenGL PyOpenGL-accelerate

如果该功能自身的文档或报错信息明确要求此加速器，请将其安装到同一 Python 中并重启一次：

.\python_embeded\python.exe -s -m pip install PyOpenGL-accelerate

不要将此可选加速器警告与来自 nodes_glsl.py 的 RuntimeError: OpenGL dependencies not available 混淆。后者是内置 GLSL 节点的另一个缺失依赖项错误；请针对该情况参阅 OpenGL 依赖项指南。

第一步：复制确切的缺失模块名称

从复制的那一行开始，而不是你猜测的包名：

ModuleNotFoundError: No module named 'sageattention'

导入名称和 pip 包名并不总是相同。例如，cv2 通常来自 OpenCV 包，而 segment_anything 来自 segment-anything。

第二步：找到启动 ComfyUI 的 Python

对于 Windows 便携版，从便携包根目录运行：

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

对于手动 venv 安装：

python -m pip --version
python -m pip show <package-name>

输出路径应指向同一个 ComfyUI 环境。如果它指向系统 Python，则修复工作在错误的地方进行了。

第三步：判断缺失包是否为致命问题

并非每个缺失的可选加速包都需要立即修复。

核心导入与插件导入

这一区别会改变最安全的修复路径：

如果缺失模块来自核心启动路径，请将本页与 ComfyUI 启动失败 配合使用。如果来自插件，请将本页与 插件导入失败 配合使用。

第四步：安装具体的修复方案

当存在专项指南时，请使用专项指南：

• No module named 'sageattention'
• No module named 'cv2'
• No module named 'insightface'
• No module named 'onnx' or 'onnxruntime'
• No module named 'transformers'
• No module named 'torch'
• No module named 'triton'
• No module named 'kornia'
• No module named 'spandrel'
• No module named 'simpleeval'
• No module named 'pydantic_settings'
• No module named 'yaml'
• No module named 'PIL'
• No module named 'safetensors'
• No module named 'einops'
• No module named 'scipy'
• No module named 'torchsde'
• No module named 'av'
• No module named 'aiohttp'
• No module named 'requests'

不要一次性安装所有相关包。每次修复后重启，并查看新的第一条错误。

包名、pip 命令还是 requirements 文件？

当指南或修复工具要求输入包名时，不要粘贴整个 shell 命令，除非它明确要求。

这一区别很重要，因为将完整命令或文件路径当作包名使用可能在修复任何内容之前就已失败。如果问题来自插件，优先使用该插件自身的 requirements.txt，而非大范围修改环境。

第五步：验证修复效果

重启 ComfyUI 之前，先在同一 Python 中验证导入：

python -c "import <module_name>; print('import ok')"

对于 Windows 便携版，使用：

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

然后重启 ComfyUI。原来的 ModuleNotFoundError 应该消失了，受影响的自定义节点或工作流应该可以正常加载。如果出现新的缺失包，将其视为下一个首要阻塞问题处理。

何时 pip install 不是正确的下一步

在安装任何内容之前，请停下来重新检查，如果出现以下情况：

• 每次重启后缺失模块都在变化
• 安装成功但 ComfyUI 仍然报告相同的缺失名称
• 你在混用系统 Python 和 python_embeded
• 同时出现了 Torch、CUDA 或 wheel/DLL 错误
• 安装单个插件后有多个插件开始失败
• 你准备将 pip install ... 或 requirements.txt 粘贴到一个只期望包名的字段中

这种模式通常意味着环境发生了漂移，而不是单独缺少某个包。

何时 Wonderful Launcher 是更好的下一步

当只有一个明确缺失的导入时，手动包修复是可行的。但在以下情况下它会变得有风险：

• 多个自定义节点在启动时失败
• 每次安装后 pip check 报告冲突
• 修复插件期间 CUDA 或 Torch 发生了变化
• 你不确定哪个 Python 启动了 ComfyUI
• 工作流很重要，你需要保留模型和设置

相关指南

• ComfyUI 依赖项冲突
• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI Python 嵌入环境详解
• 安全安装自定义节点
• ComfyUI 中 Safetensors 文件的存放位置

参考来源

• ComfyUI 自定义节点故障排查指南
• ComfyUI 故障排查概述
• ComfyUI 自定义节点故障排查指南
• PyOpenGL-accelerate 项目说明