OpenCV的Python绑定在Ubuntu/Debian上导入失败，主因是缺失libglib2.0-0、libsm6、libxrender1、libxext6等系统库；一次性执行sudo apt-get install libglib2.0-0 libsm6 libxrender1 libxext6即可解决。
Ubuntu/Debian 系统缺少 libglib2.0-0、libsm6 等基础库
OpenCV 的 Python 绑定在 Linux 上运行时，不只依赖 Python 包本身，还依赖若干系统级共享库。cv2 导入失败（如报 ImportError: libglib-2.0.so.0: cannot open shared object file）或调用 cv2.imshow() 崩溃，大概率是这些库没装。
最常缺的几个是：libglib2.0-0、libsm6、libxrender1、libxext6。它们支撑 GUI 显示、字体渲染、X11 通信等底层功能。
- 一次性安装全部（推荐）：
sudo apt-get install libglib2.0-0 libsm6 libxrender1 libxext6 - 如果用的是 Ubuntu 22.04+ 或较新发行版，可能还需
libglib2.0-0t64（注意后缀t64），否则仍报错 - 仅需命令行处理图像（不用
cv2.imshow或cv2.VideoCapture）？可跳过，但多数调试场景绕不开
CentOS/RHEL 系统缺少 glib2、libSM、libXrender
Red Hat 系列默认不预装 OpenCV 所需的 GUI 支持库，import cv2 可能静默成功，但一调用视频或窗口函数就段错误（Segmentation fault）。
对应包名与 Ubuntu 不同，必须用 yum 或 dnf 安装：
立即学习“Python免费学习笔记（深入）”；
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- CentOS 7 / RHEL 7：
sudo yum install glib2 libSM libXrender libXext - CentOS 8+ / RHEL 8+：
sudo dnf install glib2 libSM libXrender libXext - 若提示
libglib-2.0.so.0: cannot open shared object file，额外装：sudo dnf install glib2-devel（仅开发头文件不够，运行时需要glib2主包）
Windows 上 DLL load failed 但已装 VC++ 运行库
即使装了 Visual C++ 2015–2022 redistributable，仍报 ImportError: DLL load failed，说明缺失的是 OpenCV 自身依赖的编解码器或媒体框架组件，而非纯 C++ 运行时。
- Windows N / KN 版本用户：必须单独安装 Windows Media Feature Pack，否则
cv2.VideoCapture无法读 MP4/AVI - Windows Server 用户：需在“服务器管理器 → 添加角色和功能 → 功能 → Media Foundation”中启用该功能
- 检查是否被安全软件拦截：某些国产杀软会静默阻止
cv2加载 DLL，临时关闭后重试可验证
conda 环境中 LD_LIBRARY_PATH 未包含 OpenCV 动态库路径
conda 安装的 opencv 把 .so 文件放在环境的 lib/ 下（如 $CONDA_PREFIX/lib/libopencv_core.so.408），但系统默认不查这个路径，导致导入时找不到符号。
临时修复（验证用）：export LD_LIBRARY_PATH=$CONDA_PREFIX/lib:$LD_LIBRARY_PATH
永久生效（推荐）：
- 把上面那行加到
$CONDA_PREFIX/etc/conda/activate.d/env_vars.sh（创建该文件） - 或在
~/.bashrc中对特定环境做判断：if [ "$CONDA_DEFAULT_ENV" = "myenv" ]; then export LD_LIBRARY_PATH=$CONDA_PREFIX/lib:$LD_LIBRARY_PATH; fi - 注意：不要全局设置
LD_LIBRARY_PATH，可能破坏其他 conda 包的加载顺序
系统依赖不是“装了 pip 就完事”的环节，它藏得深、报错隐晦，且不同发行版命名差异大。真正卡住的时候，往往不是代码写错了，而是 libglib 少了个 t64 后缀，或是 Windows N 版本忘了装 Media Feature Pack —— 这些细节不查日志根本意识不到。
