文章目录
一、简介
-
本文提到的报错信息，是在 ubuntu-22.04 中通过 miniconda3 创建的 python-3.10 版本的虚拟环境下安装的 labelcloud 提示的报错，使用 pip 安装。
-
参考如下版本信息，如果有相关的报错可以参考本文的解决方法执行。部分问题也可以通过减低版本 来解决，需要具体情况具体分析。这里不保证完全有效，仅供参考。
bash# Name Version Build Channel _libgcc_mutex 0.1 main _openmp_mutex 5.1 1_gnu addict 2.4.0 pypi_0 pypi asttokens 3.0.1 pypi_0 pypi attrs 25.4.0 pypi_0 pypi blinker 1.9.0 pypi_0 pypi bzip2 1.0.8 h5eee18b_6 ca-certificates 2025.12.2 h06a4308_0 certifi 2026.1.4 pypi_0 pypi charset-normalizer 3.4.4 pypi_0 pypi click 8.3.1 pypi_0 pypi comm 0.2.3 pypi_0 pypi configargparse 1.7.1 pypi_0 pypi contourpy 1.3.2 pypi_0 pypi cycler 0.12.1 pypi_0 pypi dash 3.3.0 pypi_0 pypi decorator 5.2.1 pypi_0 pypi exceptiongroup 1.3.1 pypi_0 pypi executing 2.2.1 pypi_0 pypi expat 2.7.3 h7354ed3_4 fastjsonschema 2.21.2 pypi_0 pypi flask 3.1.2 pypi_0 pypi fonttools 4.61.1 pypi_0 pypi idna 3.11 pypi_0 pypi importlib-metadata 8.7.1 pypi_0 pypi ipython 8.37.0 pypi_0 pypi ipywidgets 8.1.8 pypi_0 pypi itsdangerous 2.2.0 pypi_0 pypi jedi 0.19.2 pypi_0 pypi jinja2 3.1.6 pypi_0 pypi joblib 1.5.3 pypi_0 pypi jsonschema 4.25.1 pypi_0 pypi jsonschema-specifications 2025.9.1 pypi_0 pypi jupyter-core 5.9.1 pypi_0 pypi jupyterlab-widgets 3.0.16 pypi_0 pypi kiwisolver 1.4.9 pypi_0 pypi labelcloud 1.1.1 pypi_0 pypi ld_impl_linux-64 2.44 h153f514_2 libexpat 2.7.3 h7354ed3_4 libffi 3.4.4 h6a678d5_1 libgcc 15.2.0 h69a1729_7 libgcc-ng 15.2.0 h166f726_7 libgomp 15.2.0 h4751f2c_7 libnsl 2.0.0 h5eee18b_0 libstdcxx 15.2.0 h39759b7_7 libstdcxx-ng 15.2.0 hc03a8fd_7 libuuid 1.41.5 h5eee18b_0 libxcb 1.17.0 h9b100fa_0 libzlib 1.3.1 hb25bd0a_0 markupsafe 3.0.3 pypi_0 pypi matplotlib 3.10.8 pypi_0 pypi matplotlib-inline 0.2.1 pypi_0 pypi narwhals 2.14.0 pypi_0 pypi nbformat 5.10.4 pypi_0 pypi ncurses 6.5 h7934f7d_0 nest-asyncio 1.6.0 pypi_0 pypi numpy 1.26.4 pypi_0 pypi open3d 0.19.0 pypi_0 pypi openssl 3.0.18 hd6dcaed_0 packaging 25.0 pypi_0 pypi pandas 2.3.3 pypi_0 pypi parso 0.8.5 pypi_0 pypi pexpect 4.9.0 pypi_0 pypi pillow 12.1.0 pypi_0 pypi pip 25.3 pyhc872135_0 platformdirs 4.5.1 pypi_0 pypi plotly 6.5.0 pypi_0 pypi prompt-toolkit 3.0.52 pypi_0 pypi pthread-stubs 0.3 h0ce48e5_1 ptyprocess 0.7.0 pypi_0 pypi pure-eval 0.2.3 pypi_0 pypi pygments 2.19.2 pypi_0 pypi pyopengl 3.1.10 pypi_0 pypi pyopengl-accelerate 3.1.10 pypi_0 pypi pyparsing 3.3.1 pypi_0 pypi pyqt5 5.15.11 pypi_0 pypi pyqt5-qt5 5.15.18 pypi_0 pypi pyqt5-sip 12.17.2 pypi_0 pypi pyquaternion 0.9.9 pypi_0 pypi python 3.10.19 h6fa692b_0 python-dateutil 2.9.0.post0 pypi_0 pypi pytz 2025.2 pypi_0 pypi pyyaml 6.0.3 pypi_0 pypi readline 8.3 hc2a1206_0 referencing 0.37.0 pypi_0 pypi requests 2.32.5 pypi_0 pypi retrying 1.4.2 pypi_0 pypi rpds-py 0.30.0 pypi_0 pypi scikit-learn 1.7.2 pypi_0 pypi scipy 1.15.3 pypi_0 pypi setuptools 80.9.0 py310h06a4308_0 six 1.17.0 pypi_0 pypi sqlite 3.51.0 h2a70700_0 stack-data 0.6.3 pypi_0 pypi threadpoolctl 3.6.0 pypi_0 pypi tk 8.6.15 h54e0aa7_0 tqdm 4.67.1 pypi_0 pypi traitlets 5.14.3 pypi_0 pypi typing-extensions 4.15.0 pypi_0 pypi tzdata 2025.3 pypi_0 pypi urllib3 2.6.2 pypi_0 pypi wcwidth 0.2.14 pypi_0 pypi werkzeug 3.1.4 pypi_0 pypi wheel 0.45.1 py310h06a4308_0 widgetsnbextension 4.0.15 pypi_0 pypi xorg-libx11 1.8.12 h9b100fa_1 xorg-libxau 1.0.12 h9b100fa_0 xorg-libxdmcp 1.1.5 h9b100fa_0 xorg-xorgproto 2024.1 h5eee18b_1 xz 5.6.4 h5eee18b_1 zipp 3.23.0 pypi_0 pypi zlib 1.3.1 hb25bd0a_0
二、pip 安装的报错&解决方法
-
容器是精简版的 Linux，默认没有 libGL 图形驱动库，所以会提示找不到文件。
bashTraceback (most recent call last): File "/opt/miniconda3/envs/labelcloud/bin/labelCloud", line 7, in <module> sys.exit(main()) File "/opt/miniconda3/envs/labelcloud/lib/python3.10/site-packages/labelCloud/__main__.py", line 25, in main start_gui() File "/opt/miniconda3/envs/labelcloud/lib/python3.10/site-packages/labelCloud/__main__.py", line 80, in start_gui from PyQt5.QtWidgets import QApplication, QDesktopWidget ImportError: libGL.so.1: cannot open shared object file: No such file or directory -
使用如下指令解决上述
libGL报错。bashapt install -y \ libgl1-mesa-glx \ libglib2.0-0 \ libfontconfig1 \ libxrender1 \ libxcb-xinerama0 \ libusb-1.0-0 -
3D 软件在 Linux 环境下的一个特定依赖：GLU (OpenGL Utility Library)。
bash/opt/miniconda3/envs/labelcloud/lib/python3.10/site-packages/labelCloud/control/config_manager.py:7: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81. import pkg_resources Failed to load library ( 'libGLU.so.0' ): libGLU.so.0: cannot open shared object file: No such file or directory qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found. This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem. Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl, xcb. Aborted (core dumped) -
使用如下指令补齐
GLU库和可能导致xcb失败的依赖。bashapt update && apt install -y \ libglu1-mesa \ libxcb-xinerama0 \ libxcb-cursor0 \ libxkbcommon-x11-0 libxcb-util1 \ libxcb-icccm4 \ libxcb-image0 \ libxcb-keysyms1 \ libxcb-render-util0 \ -
如果依然报
xcb的错误，执行如下指令排查问题。bash# 切换到你的 labelme 环境插件目录 cd /opt/miniconda3/envs/labelcloud/lib/python3.10/site-packages/PyQt5/Qt5/plugins/platforms/ # 检查 libqxcb.so 的依赖状态 ldd libqxcb.so | grep "not found" -
如果有如下报错，则使用指令进一步安装：
apt update && apt install -y libxcb-shape0 libdbus-1-3补齐相关库。bashlibxcb-shape.so.0 => not found libxcb-shape.so.0 => not found libdbus-1.so.3 => not found
小结
以上内容作为错误记录，仅供参考，如有其他问题欢迎在评论区讨论！！