Ubuntu下VSCode运行Python时缺失Qt wayland插件问题求助

问题复现 #

运行以下Python脚本时无法正常绘图：

from matplotlib import pyplot as plt
plt.plot([1,2,3], [5,4,3])
plt.show()

输出错误信息：

qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in ""

环境信息 #

• Python 3.9.15
• Anaconda Navigator 2.3.2
• conda 22.11.1
• matplotlib 3.6.2
• Visual Studio Code 1.74.2
• Ubuntu 22.04.1 LTS
• GNOME 42.5
• 窗口系统：Wayland

已尝试的操作 #

• 执行sudo apt-get install -y qtwayland5安装组件，确认已是最新版本（5.15.3-1）
• 查找组件路径：
  • which qtwayland5 无输出
  • whereis qtwayland5 返回qtwayland5:
  • locate qtwayland5 输出：

    /usr/share/doc/qtwayland5
    /usr/share/doc/qtwayland5/changelog.Debian.gz
    /usr/share/doc/qtwayland5/copyright
    /var/cache/apt/archives/qtwayland5_5.15.3-1_amd64.deb
    /var/lib/dpkg/info/qtwayland5:amd64.list
    /var/lib/dpkg/info/qtwayland5:amd64.md5sums
    

• 尝试查找Wayland和Qt相关路径，但结果过多，无法确定正确的路径添加到$PATH

解决方案 #

方案1：切换Matplotlib后端 #

直接在代码中指定不依赖Qt的后端，比如TkAgg：

from matplotlib import pyplot as plt
plt.switch_backend('TkAgg')
plt.plot([1,2,3], [5,4,3])
plt.show()

或者尝试Wayland专属后端（需确保环境支持）：

plt.switch_backend('WaylandAgg')

方案2：指定Qt平台插件环境变量 #

在VSCode的终端中先设置环境变量，再运行脚本：

export QT_QPA_PLATFORM=wayland
python your_script.py

若需永久生效，可将该环境变量添加到~/.bashrc或~/.zshrc文件中。

方案3：在conda环境中安装QtWayland #

系统安装的Qt组件可能无法被conda环境中的Matplotlib识别，直接在conda环境内安装：

conda activate your_env_name
conda install -c conda-forge qtwayland

安装完成后重新运行脚本即可。

方案4：修改VSCode的运行环境配置 #

在VSCode的launch.json中添加环境变量，确保运行时加载正确的Qt平台：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "QT_QPA_PLATFORM": "wayland"
            }
        }
    ]
}

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