python库报错汇总

形如ModuleNotFoundError: No module named 'xxx'的报错

先确认报错来自哪个 Python 环境，再查项目依赖。导入名不一定等于安装包名，也可能被项目里的同名文件遮蔽。下方统一使用 python -m pip，让 pip 与运行程序的解释器一致；请在项目虚拟环境里按需安装。

ModuleNotFoundError: No module named ‘cv2’

python -m pip install opencv-python

cv2 来自 OpenCV。需要 contrib 功能时改选 opencv-contrib-python；无桌面环境可选相应 headless 包，同一环境只保留一种 OpenCV wheel，避免共同写入 cv2。

ModuleNotFoundError: No module named ‘colour.io’; ‘colour’ is not a package

python -m pip install colour-science

还要检查项目内是否有 colour.py 或 colour 目录遮蔽第三方包，以及环境里是否误装了不同用途的 colour 包。可用 python -c "import colour; print(colour.__file__)" 确认实际导入位置。

No module named ‘cpuinfo’

python -m pip install py-cpuinfo

ModuleNotFoundError: No module named ‘imageio‘

python -m pip install imageio

解决ModuleNotFoundError: No module named ‘skimage‘

python -m pip install scikit-image

No module named ‘open_clip‘

python -m pip install open_clip_torch

ERROR: No matching distribution found for triton

先检查项目是否必须使用 Triton，以及所需 Python、平台和 PyTorch 版本。下面是当时使用的第三方 Windows wheel 记录，不能用于任意环境；cp311 仅对应 CPython 3.11，win_amd64 对应 64 位 Windows。下载前核对项目支持范围和文件来源。

历史来源：madbuda/triton-windows-builds · HF Mirror

cd 下载目录
python -m pip install triton-3.0.0-cp311-cp311-win_amd64.whl  # 文件名

ImportError: cannot import name ‘soft_unicode‘ from ‘markupsafe‘

该错误通常是旧版依赖仍导入已移除的 soft_unicode。先更新实际调用它的依赖，并检查项目的版本约束。下面的固定旧版本只作为原项目的兼容记录，不作为所有环境的通用修复：

python -m pip install markupsafe==2.0.1

No module named ‘sklearn’

python -m pip install scikit-learn

其他

ERROR: Could not install packages due to an OSError: [WinError 5] 拒绝访问。： ‘E:\conda\envs\deepl\Lib\site-packages\cv2\cv2.pyd’ Consider using the --user option or check the permissions.

先关闭占用 cv2.pyd 的 Python、Notebook、IDE 或摄像头程序，再在同一虚拟环境重试。仍失败时检查环境目录的写权限，并用 python -m pip check 检查依赖冲突。不要为了绕过文件占用直接加 --user；它会改变安装位置，在部分虚拟环境中也不可用。