cv2 找不到或导入失败：先分清 OpenCV 四种安装包
区分普通版、contrib 和 headless，检查同一命名空间的重复安装，再处理 DLL 或原生库错误。
这几个名字不是四个独立插件
维护者发布普通版、contrib 版及各自的 headless 版；它们都使用同一个 cv2 命名空间，因此明确要求同一环境只选一种。headless 版不含 cv2.imshow 等 OpenCV GUI 功能；浏览器界面能打开，不等于节点需要这些桌面功能。维护者安装说明与 FAQ
先做安装记录盘点
下面只查询，不会卸载文件。仍应使用启动当前 ComfyUI 的解释器。
python -m pip show opencv-python opencv-contrib-python opencv-python-headless opencv-contrib-python-headless
先记录四种分发包的查询结果与受影响节点的依赖要求。若可信的 cv2 已能导入，可在相同解释器里查看 cv2.__file__，确认实际加载位置；手工遗留的旧 cv2 文件即使不出现在 pip 元数据中，也可能造成冲突。维护者建议重新安装前移除这种旧绑定。不要把“再装一种试试”当作默认策略。维护者说明
缺包和 DLL 失败分开处理
No module named cv2 应检查解释器、安装记录与导入路径；Windows 的 DLL load failed 应保留完整错误，按维护者的条件性平台要求核对 Visual C++ 运行库，N/KN 版本还应核对 Media Feature Pack。它们不是所有机器通用的修复。不要从无关下载站取得同名 DLL 覆盖系统目录。维护者 FAQ
复查应回到原任务
若确有重复安装，先保存可恢复的环境副本和节点依赖记录；维护者给出的处理方式是卸载冲突的 OpenCV 分发包，再只装选定的一种，应先在副本中测试。可信包成功导入只是中间检查；重启同一 ComfyUI 实例，重跑原来的预处理或读图节点。读图成功但窗口显示失败，应单独调查 GUI 路线。维护者说明
相关排查
资料复核并审阅中文：2026-09-26。本站未在本地改动软件包、导入原生模块、运行图像节点或 GPU。
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- 提示缺少 yaml、PIL 或 pydantic_settings：先核对包名，不要照抄报错安装
No module named yaml把报错里的导入名称、安装名称和实际运行环境分开检查，避免装错包或装到另一套 Python。 - MMCV 安装失败或缺少算子：先核对构建组合
No module named mmcv区别 mmcv 与 mmcv-lite，并将源码构建失败和运行期扩展加载失败分开处理。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
2026-09-26 复核 OpenCV Python 维护者当前 PyPI 安装说明与 FAQ，并独立审阅中文；未在本地改包、导入原生模块或运行节点/GPU。
01OpenCV Python distribution maintainers资料核对: 2026-09-26