解決在 Docker 中啟動(dòng) labelImg 的相關(guān)報(bào)錯(cuò)

更新時(shí)間：2026年01月05日 09:46:24 作者：飯來_

文章介紹了在Ubuntu-22.04中使用Miniconda3創(chuàng)建的Python 3.10虛擬環(huán)境下安裝labelImg時(shí)遇到的兩個(gè)主要錯(cuò)誤及其解決方法：libGL報(bào)錯(cuò)和xcb插件報(bào)錯(cuò),解決方法包括安裝libGL庫和補(bǔ)齊Qt5的xcb依賴項(xiàng),感興趣的朋友跟隨小編一起看看吧

一、簡(jiǎn)介

本文提到的報(bào)錯(cuò)信息，是在 ubuntu-22.04 中通過 miniconda3 創(chuàng)建的 python-3.10 版本的虛擬環(huán)境下安裝的labelImg提示的報(bào)錯(cuò)。參考如下版本信息，如果有相關(guān)的報(bào)錯(cuò)可以參考本文的解決方法執(zhí)行。部分問題也可以通過 減低版本 來解決，需要具體情況具體分析。這里不保證完全有效，僅供參考。

# Name                    Version                   Build  Channel
_libgcc_mutex             0.1                        main  
_openmp_mutex             5.1                       1_gnu  
bzip2                     1.0.8                h5eee18b_6  
ca-certificates           2025.12.2            h06a4308_0  
expat                     2.7.3                h7354ed3_4  
labelimg                  1.8.6                    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  
lxml                      6.0.2                    pypi_0    pypi
ncurses                   6.5                  h7934f7d_0  
openssl                   3.0.18               hd6dcaed_0  
pip                       25.3               pyhc872135_0  
pthread-stubs             0.3                  h0ce48e5_1  
pyqt5                     5.15.11                  pypi_0    pypi
pyqt5-qt5                 5.15.18                  pypi_0    pypi
pyqt5-sip                 12.17.2                  pypi_0    pypi
python                    3.10.19              h6fa692b_0  
readline                  8.3                  hc2a1206_0  
setuptools                80.9.0          py310h06a4308_0  
sqlite                    3.51.0               h2a70700_0  
tk                        8.6.15               h54e0aa7_0  
tzdata                    2025b                h04d1e81_0  
wheel                     0.45.1          py310h06a4308_0  
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  
zlib                      1.3.1                hb25bd0a_0

二、libGL 報(bào)錯(cuò)&解決方法

容器是精簡(jiǎn)版的 Linux，默認(rèn)沒有 libGL 圖形驅(qū)動(dòng)庫，所以會(huì)提示找不到文件。

Traceback (most recent call last):
  File "/opt/miniconda3/envs/labelImg/lib/python3.10/site-packages/labelImg/labelImg.py", line 18, in <module>
    from PyQt5.QtGui import *
ImportError: libGL.so.1: cannot open shared object file: No such file or directory
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
  File "/opt/miniconda3/envs/labelImg/bin/labelImg", line 3, in <module>
    from labelImg.labelImg import main
  File "/opt/miniconda3/envs/labelImg/lib/python3.10/site-packages/labelImg/labelImg.py", line 27, in <module>
    import sip
ModuleNotFoundError: No module named 'sip'

執(zhí)行如下指令解決上述 libGL 報(bào)錯(cuò)。

apt update && apt install -y libgl1-mesa-glx libglib2.0-0 libx11-xcb1

執(zhí)行如下指令解決上述 python 依賴，其實(shí)在安裝 labelimg 的時(shí)候已經(jīng)安裝過了。

# 1. 先安裝 pyqt5 相關(guān)的 sip
pip install PyQt5-sip
# 2. 重新安裝 pyqt5 (確保版本完整)
pip install PyQt5
# 3. 如果依然報(bào)錯(cuò)，嘗試安裝特定版本的 lxml
pip install lxml

需要注意，容器內(nèi)指定的顯示器編號(hào)需要和宿主機(jī)一致，并且需要具有權(quán)限可視化，應(yīng)最先確認(rèn)如下信息。
```
echo $DISPLAY  # 獲取宿主機(jī)顯示器編號(hào)
echo "export DISPLAY=:1" >> ~/.bashrc  # 在容器內(nèi)指定相同編號(hào)，以 1 為例   
```

三、xcb 插件報(bào)錯(cuò)&解決方法

報(bào)錯(cuò) xcb 插件加載失敗，是因?yàn)?PyQt5 運(yùn)行所需的底層 XCB 相關(guān)庫在容器內(nèi)還不完整。

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)

執(zhí)行如下指令，補(bǔ)齊 Qt5 缺失的所有 xcb 依賴。

apt update && apt install -y \
    libxcb-xinerama0 \
    libxcb-icccm4 \
    libxcb-image0 \
    libxcb-keysyms1 \
    libxcb-render-util0 \
    libxcb-xfixes0 \
    libxcb-shape0 \
    libxcb-randr0 \
    libxkbcommon-x11-0 \
    libdbus-1-3

小結(jié)

以上內(nèi)容作為錯(cuò)誤記錄，僅供參考，不保證完全有效，后續(xù)會(huì)不斷增加。如有其他問題歡迎在評(píng)論區(qū)討論??！

到此這篇關(guān)于解決在 Docker 中啟動(dòng) labelImg 的相關(guān)報(bào)錯(cuò)的文章就介紹到這了,更多相關(guān)docker啟動(dòng)labelImg報(bào)錯(cuò)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: