无UI Linux环境运行YOLOv5遇OpenCV依赖libGL.so.1缺失错误

问题原因 #

无UI的Linux环境（如GitHub Codespaces、无UI树莓派OS）默认未安装OpenCV依赖的图形系统库，导致导入cv2时触发libGL.so.1: cannot open shared object file: No such file or directory错误。

解决方案 #

1. 安装系统级依赖库 #

针对Debian/Ubuntu系发行版（涵盖Codespaces和树莓派OS），执行以下命令安装缺失的库：

sudo apt update && sudo apt install -y libgl1-mesa-glx

2. 树莓派无UI系统额外适配 #

若在无UI树莓派OS中运行，可补充安装以下依赖确保兼容性：

sudo apt install -y libglib2.0-0

3. 验证摄像头访问权限（针对source 0） #

如果使用摄像头作为输入源（--source 0），需确保当前用户有权限访问摄像头设备：

sudo usermod -aG video $USER

执行后需重新登录终端，权限才会生效。

4. 重新运行检测命令 #

完成上述步骤后，再次执行YOLOv5检测命令：

python detect.py --weights real.pt --source 0

内容的提问来源于stack exchange，提问作者Sean Mabli