Linux qt "qt.qpa.plugin: Could not load the Qt platform plugin "xcb" " error解决方法

最新推荐文章于 2025-11-08 16:13:03 发布

原创最新推荐文章于 2025-11-08 16:13:03 发布 · 5w 阅读

46 ·

CC 4.0 BY-SA版权

文章标签：

#linux #qt

Qt 专栏收录该内容

9 篇文章

订阅专栏

本文详细介绍了在调试Qt项目时遇到的qt.qpa.plugin:CouldnotloadtheQtplatformplugin错误的解决步骤。从重新安装依赖库开始，到环境配置、修改Qt配置，直至重新安装Qt，提供了全面的解决方案。

在调试qt项目时遇到如下问题

qt.qpa.plugin: Could not load the Qt platform plugin "xcb"...

此问题大多是因为QT库依赖配置有问题，或是qt未正确安装...

解决方法

第一步：重新安装依赖库

sudo apt-get install libx11-dev libxext-dev libxtst-dev

sudo apt-get install xlibmesa-gl-dev libglu1-mesa-dev

若问题依然存在，则执行第二步

第二步：环境配置

打开/etc/profile文件，该文件是每个用户登录时都会运行的环境变量设置 .bashfile 是单用户登录时比如root会运行的。

vim /etc/profile
#在文件末尾添加
export PATH="/home/hf/Qt5.12./Tools/QtCreator/bin:$PATH"
export PATH="/home/hf/Qt5.12.0/5.12.0/gcc_64/bin:$PATH"

注意：/home/hf/Qt5.12.0/即你的qt安装路径

保存profile文件后执行source /etc/profile命令即可修改环境变量

终端下执行qtcreator命令即可打开Qt，执行qmake命令即可执行该命令

若问题依然存在，则执行第三步

第三步：修改qt配置

sudo vi /usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf
#修改文件 将第一行改为bin目录的路径,第二行改为qt安装目录的路径
/home/hf/Qt5.12.0/5.12.0/gcc_64/bin
/home/hf/Qt5.12.0

若问题依然存在，则执行第四步

第四步：重新安装qt

https://blog.youkuaiyun.com/jiguangfan/article/details/86489768

参考链接：

https://blog.youkuaiyun.com/x356982611/article/details/70799165

https://forum.qt.io/topic/52356/static-qt-this-application-failed-to-start-because-it-could-not-find-or-load-the-qt-platform-plugin-xcb/2