QtQuick程序在ubuntu测试机上运行提示module "QtQuick.Controls" is not installed

最新推荐文章于 2025-06-27 09:01:41 发布

原创最新推荐文章于 2025-06-27 09:01:41 发布 · 9.8k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#qt5 #module #QtQuick

本文详细阐述了解决使用Qt5.3.1在openSourcex64forlinux环境下编译并运行后的程序，在另一台测试机上因QtQuick.Controls库未安装而导致的'module QtQuick.Controls is not installed'错误。通过分析ldd命令输出的链接库路径，最终确定了解决方案为安装QtQuick.Controls和QtQuick.Layouts的运行库，即qtdeclarative5-controls-plugin和qtdeclarative5-quicklayouts-plugin。这一过程揭示了Qt程序跨机运行时，库文件配置的重要性，以及如何通过正确安装运行库来确保程序的兼容性和稳定性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我的开发机上安装的是从Qt官网(qt-project.org/downloads)下载的Qt 5.3.1 openSource x64 for linux,编译运行都很正常,但是在将release版本的程序拷贝到一台干净的测试机上运行时却提示module "QtQuick.Controls" is not installed,网上的建议是添加环境变量QML2_IMPORT_PATH(Qt官方参考网站:http://qt-project.org/doc/qt-5/qtqml-syntax-imports.html#qml-import-path),但是实际上测试机上根本就没有QML2的库,这个path怎么写肯定也不对的,而且我的开发机上也没有这个变量,说明程序不是靠这个环境变量来定位所需的库的,通过ldd命令检查该程序默认的链接库路径是/usr/lib/x86_64-linux-gnu/qt5/qml/,但是在该目录下搜索却并没有名字类似libcontrols.so的库,在其他位置搜索也没有发现类似的库,后来终于找到了解决办法,就是安装运行库(囧,仔细想想好像本来就该这么做)QtQuick.Controls运行需要安装运行库:qtdeclarative5-controls-plugin,而QtQuick.Layouts对应的库是qtdeclarative5-quicklayouts-plugin.安装完之后链接库目录下会出现/QtQuick/Controls,/QtQuick/Layouts,程序就可以正常运行了.