MMCV 安装失败或缺少算子：先核对构建组合

别只看最后的退出码

当前 MMCV 2.x 安装页把完整分发包称为 mmcv，把不含 CUDA 算子的版本称为 mmcv-lite，并明确警告二者不能在同一环境混装。匹配的预编译包通常在日志中显示 .whl，走源码构建路径则会看到 .tar.gz；它们比最后的退出码更有诊断价值。旧 1.x 资料可能称完整包为 mmcv-full，复制命令前须核对节点要求的主版本。当前安装说明

本文建议先对照四项

用受影响节点实际使用的解释器，记录 MMCV 主版本、Python 版本、Torch/CUDA 构建、平台信息，并查清是否把完整包与 lite 版同时装入：

python -m pip show mmcv mmcv-lite torch

缺少 _ext 不证明顶层 Python 包不存在：lite 路线不提供 CUDA 算子，完整构建也可能未能加载原生扩展。保留确切导入或加载错误。安装失败时，记录选择的是 .whl 还是 .tar.gz，以及第一处具体编译或链接错误，而不只记 exit code 1。

怎样选择下一步

先查节点作者的版本限制，再按 Python、Torch/CUDA、MMCV 和平台选择上游支持的组合。没有匹配 wheel 时，源码构建应在隔离副本中单独规划。不要混装 mmcv 与 mmcv-lite、用近似名字的 wheel 顶替，或首先卸载所有 Torch 相关包。安装说明

验收

先确认可信顶层包可导入，再分别验证节点实际需要的算子与最小原节点工作流。只打印版本号不能证明编译算子已加载或执行。应在可恢复环境副本中测试，并核对其他保留工作流是否被新组合影响。

相关排查

• SAM、GroundingDINO 加载失败：代码、权重和原生扩展分开检查
• Nunchaku 装好了还报错：把节点、Python 库和模型权重分别核对

资料复核并审阅中文：2026-09-26。本站未在本地安装包、源码编译、加载算子、运行工作流或 GPU。