Package | 解决 ImportError: libGL.so.1: cannot open shared object file: No such file or directory

最新推荐文章于 2025-07-06 16:59:01 发布

原创最新推荐文章于 2025-07-06 16:59:01 发布 · 5.1w 阅读

109 ·

CC 4.0 BY-SA版权

文章标签：

#libGL #openGL

Package 专栏收录该内容

12 篇文章

订阅专栏

本文介绍了解决在本地或docker环境中遇到的“ImportError:libGL.so.1:cannot open shared object file: No such file or directory”错误的方法。通过安装GL库解决了这一问题，并解释了libGL的作用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

.

背景

在本机/docker环境里经常遇到这个报错，每次都先找解决方案。因为近期遇到这个报错太频繁，还是决定记录一下。

.

问题

运行程序，出现报错信息如下：

ImportError: libGL.so.1: cannot open shared object file: No such file or directory

从字面上理解，环境钟缺少libGL.so.1文件，即缺少GL库文件。
搜索得到libGL的定义如下：

OpenGL-based programs must link with the libGL library. libGL implements the GLX interface as well as the main OpenGL API entrypoints. When using indirect rendering, libGL creates GLX protocol messages and sends them to the X server via a socket. When using direct rendering, libGL loads the appropriate 3D DRI driver then dispatches OpenGL library calls directly to that driver.

原文链接：libGL