ModuleNotFoundError: No module named ‘ultralytics’

快速结论：该报错通常在 Stability Matrix 启动 ComfyUI 并加载 Impact Pack 时出现，优先排查 Windows 下 Stability Matrix 环境中的权限问题，并尝试直接为该 Python 环境手动安装缺失的 ultralytics 包。

问题场景

用户在 Stability Matrix 中启动 ComfyUI，Impact Pack 插件在加载 impact/subcore.py 脚本时，因 Python 环境缺少 ultralytics 包而失败。安装过程中也可能触发 OSError: [WinError 5] Access is denied 权限错误。

报错原文

Installing collected packages: opencv-python, pandas, thop, seaborn, ultralytics
ERROR: Could not install packages due to an OSError: [WinError 5] Access is denied: 'C:\\Users\\user\\AppData\\Roaming\\StabilityMatrix\\Packages\\ComfyUI\\venv\\Lib\\site-packages\\cv2\\cv2.pyd'
Check the permissions.

### ComfyUI-Impact-Pack: (IMPORT FAILED) Subpack

  The module at the `custom_nodes/ComfyUI-Impact-Pack/impact_subpack` path appears to be incomplete.
Traceback (most recent call last):
  Recommended to delete the path and restart ComfyUI.
  File "...\custom_nodes\ComfyUI-Impact-Pack\__init__.py", line 406, in 
  If the issue persists, please report it to https://github.com/ltdrdata/ComfyUI-Impact-Pack/issues.
    import impact.subpack_nodes

  File "...\impact_subpack\impact\subpack_nodes.py", line 4, in 
---------------------------------
    import impact.subcore as subcore
  File "...\impact_subpack\impact\subcore.py", line 10, in 
---------------------------------
    from ultralytics import YOLO

ModuleNotFoundError: No module named 'ultralytics'

原因分析

Stability Matrix 在 Windows 上启动 ComfyUI 时，会先导入大量其他模块，之后才允许自定义节点的安装脚本运行。这导致 Impact Pack 的依赖（如 ultralytics）安装时机过晚，同时因 cv2.pyd 等文件已被占用而触发权限错误。本质上是一个包安装顺序与 Windows 特权隔离组合导致的兼容性问题。

环境排查

操作系统：Windows（该问题在 Windows 上特异性出现）
启动工具：Stability Matrix
节点包：ComfyUI-Impact-Pack（要求 ultralytics 包）
Python 环境：Stability Matrix 内部的 venv（路径类似 ...\Packages\ComfyUI\venv\）
权限状态：普通用户运行时可能缺少写入 site-packages 目录的权限

解决步骤

完全关闭 Stability Matrix 和 ComfyUI，确保没有任何后台进程占用 Python 环境中的 DLL 文件。
以管理员身份打开 PowerShell 或命令提示符。
切换到 Stability Matrix 使用的 Python 可执行文件所在目录，例如：
cd "C:\Users\user\AppData\Roaming\StabilityMatrix\Packages\ComfyUI\venv\Scripts"
如果路径不同，请根据你的安装位置调整（常见于 AppData 或安装盘）。
直接为该 Python 环境安装 ultralytics 包（可优先尝试）：
.\python.exe -m pip install ultralytics
如果仍然遇到权限错误，尝试强制重装并避免依赖冲突（这是一个可优先尝试的替代方案，参考 Issue 中的 onnxruntime 案例）：
.\python.exe -m pip install ultralytics --no-deps --force-reinstall
如果上述步骤仍然失败，确保 pip 自身已升级：
.\python.exe -m pip install --upgrade pip，然后重试第 4 步。
安装完成后，重新启动 Stability Matrix 并加载 ComfyUI。

验证方法

重新启动 ComfyUI（通过 Stability Matrix），观察是否还出现 ModuleNotFoundError: No module named 'ultralytics' 报错。如果 Impact Pack 正常加载且日志中无导入失败记录，则问题解决。

参考来源

ltdrdata/ComfyUI-Impact-Pack #287

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

ModuleNotFoundError: No module named ‘ultralytics’