WSLg运行PyQt5项目无窗口显示的问题求助及疑问

问题背景 #

• Windows 10 搭配 WSL2 环境，WSLg 功能正常（执行 gedit & 可正常弹出窗口）
• 运行PyQt5项目及官方示例 /src/pyqt-official/qtdemo/qtdemo.py 时，无报错但窗口不弹出，仅提示“xcb plugin was loaded”
• 使用pyenv+poetry虚拟环境，曾因缺失 libxcb.so 库安装了系统级 python3-pyqt5，但问题仍未解决

问题解答 #

1. 显卡驱动未更新是否会导致该问题？ #

会。Gedit这类轻量GTK应用对渲染依赖较低，无需OpenGL加速即可正常运行；但PyQt5默认依赖Qt的OpenGL渲染框架，若WSL2的显卡驱动未支持vGPU，Qt无法正确初始化渲染上下文，可能导致窗口静默无法显示，且不会抛出明确报错。

2. 为何系统安装python3-pyqt5会影响pyenv/poetry虚拟环境？ #

通过poetry安装的PyQt5仅包含自身核心库，但其依赖的Qt xcb插件需要系统级的libxcb相关组件支持。你最初遇到的libxcb.so缺失，是因为虚拟环境中的PyQt5找不到系统底层的xcb依赖库；而安装python3-pyqt5时，apt会自动补全所有Qt xcb插件所需的系统依赖（如libxcb-xinerama0、libxcb-cursor0等），这些依赖是PyQt5运行的必要底层支撑，并非PyQt5包自带内容——所以本质是系统依赖补全后，虚拟环境的PyQt5才能正常加载xcb插件，而非系统安装的PyQt5直接干预虚拟环境。

3. 额外排查措施 #

• 强制Qt使用软件渲染：运行程序前执行 export QT_QPA_PLATFORM=xcb:gl=no，禁用OpenGL加速，强制依赖软件渲染测试窗口是否弹出
• 检查Qt插件路径：在虚拟环境中执行以下代码，确认插件路径下存在libqxcb.so文件：

  from PyQt5.QtCore import QLibraryInfo
  print(QLibraryInfo.location(QLibraryInfo.PluginsPath))
  

• 启用Qt调试日志：运行程序前设置 export QT_DEBUG_PLUGINS=1，查看详细的插件加载日志，定位是否有依赖组件加载失败
• 验证系统依赖完整性：执行 ldd $(find ~/.pyenv -name libqxcb.so)，检查输出中是否有not found的依赖项，若有则通过apt安装对应库
• 测试最简PyQt示例：运行以下极简代码，确认基础PyQt窗口能否正常显示：

  from PyQt5.QtWidgets import QApplication, QWidget
  import sys
  
  app = QApplication(sys.argv)
  win = QWidget()
  win.setWindowTitle("Test Window")
  win.show()
  sys.exit(app.exec_())
  

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