WSL Ubuntu环境下PyQt5桌面应用xcb插件启动失败求助

我在WSL Ubuntu环境下使用VSCode开发PyQt5桌面应用，项目搭建完成但启动时出现报错，错误信息如下：

qt.qpa.xcb: could not connect to display

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

已尝试但无效的方案：

• 重新安装PyQt5
• 卸载opencv-python后安装opencv-python-headless
• 执行sudo apt-get install libxcb-xinerama0
• 执行sudo apt install libxcb-cursor0

补充：已为脚本添加相关配置，但控制台输出仍异常。

可行解决步骤 #

1. 配置WSL图形界面环境 #

确保使用WSL2版本，并在Windows端安装X服务器（如VcXsrv、X410）。启动X服务器后，在WSL终端设置DISPLAY变量：

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0

将配置写入shell配置文件（如~/.bashrc），避免每次手动设置：

echo "export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0" >> ~/.bashrc
source ~/.bashrc

2. 安装完整的xcb依赖库 #

执行以下命令安装所有xcb相关依赖：

sudo apt-get update
sudo apt-get install libxcb1 libxcb-keysyms1 libxcb-image0 libxcb-shm0 libxcb-icccm4 libxcb-sync0 libxcb-xfixes0 libxcb-shape0 libxcb-randr0 libxcb-render-util0 libxcb-xinerama0 libxcb-xkb-dev libxkbcommon-x11-dev libxcb-cursor0

3. 验证并设置Qt插件路径 #

在Python中执行以下代码，查看PyQt5的库路径：

import PyQt5.QtCore
print(PyQt5.QtCore.QCoreApplication.libraryPaths())

如果输出未包含xcb插件路径，手动设置环境变量：

export QT_QPA_PLATFORM_PLUGIN_PATH=$(python3 -c "import PyQt5; print(PyQt5.__path__[0])")/Qt5/plugins/platforms

4. 应急方案：使用offscreen模式 #

若上述方法均无效，可临时切换到offscreen模式（适合无界面测试场景）：
在终端执行：

export QT_QPA_PLATFORM=offscreen

或在Python代码开头添加：

import os
os.environ['QT_QPA_PLATFORM'] = 'offscreen'

内容的提问来源于stack exchange，提问作者Raffi Martin