WSL2 Ubuntu22.04中PySide6启动报错：找不到libEGL.so.1

环境与错误详情 #

• 系统：Ubuntu WSL2 22.04
• Python环境：Poetry/venv隔离的Python 3.11.2
• 触发命令：python app.py
• 错误栈：

Traceback (most recent call last):
  File "/home/lara/projects/qtapp/app.py", line 4, in <module>
    from PySide6.QtGui import QGuiApplication
ImportError: libEGL.so.1: cannot open shared object file: No such file or directory

应用代码app.py：

from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

app = QGuiApplication()
engine = QQmlApplicationEngine()

engine.load("myqmlfile.qml")

app.exec()

pyproject.toml依赖配置：

[tool.poetry.dependencies]
python = ">=3.11,<3.12"
pyside6 = "^6.4.3"

[tool.poetry.group.dev.dependencies]
pytest = "^7.2.2"
pytest-cov = "^4.0.0"
isort = "^5.12.0"
black = "^23.3.0"
poethepoet = "^0.19.0"

修复步骤 #

这个错误源于WSL2环境缺少PySide6依赖的EGL图形驱动库，执行以下命令安装系统级依赖包：

sudo apt update
sudo apt install libegl1-mesa libgl1-mesa-glx libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-xinerama0 libxcb-xinput0 libxcb-xfixes0

安装完成后，重新激活Poetry虚拟环境（若当前未激活），再次运行python app.py即可正常启动应用。

额外注意事项 #

• Windows 11用户：默认已支持WSL图形应用，无需额外配置；
• Windows 10用户：确保WSL版本为2，且已安装WSLg组件，可通过wsl --update更新到最新版本以获取图形支持。

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