Qt编译问题大揭秘：从VS到Google全攻略

Qt编译问题大揭秘：从VS到Google全攻略

引用

CSDN

等

16

来源

1.

https://blog.csdn.net/notfindjob/article/details/138610226

2.

https://blog.csdn.net/VictorFz/article/details/139278791

3.

https://blog.csdn.net/qq_53586017/article/details/136430198

4.

https://blog.csdn.net/qianniulaoren/article/details/139028554

5.

https://m.blog.csdn.net/wangz76/article/details/137089941

6.

https://blog.csdn.net/chuandaobozi/article/details/136276242

7.

https://blog.csdn.net/m0_70788037/article/details/139346793

8.

https://blog.csdn.net/hello_coolgirl/article/details/137757345

9.

https://blog.csdn.net/DreamerPerple/article/details/138030108

10.

https://jingyan.baidu.com/tag?pn=1370&rn=10&tagName=%E5%A4%96%E8%AF%AD%E5%AD%A6%E4%B9%A0

11.

https://blog.csdn.net/m0_47587308/article/details/144645244

12.

https://www.cnblogs.com/txwtech/p/18177152

13.

https://www.cnblogs.com/xy0797/p/18372635

14.

https://doc.embedfire.com/linux/rk356x/Qt/zh/latest/lubancat_qt/install/install_arm_2.html

15.

http://www.cdweb.net/article/gijcep.html

16.

https://juejin.cn/post/7354632375445356571

在软件开发的世界里，Qt无疑是一个强大的跨平台框架，它让开发者能够用一套代码在多个操作系统上运行应用程序。然而，对于许多开发者来说，Qt的编译过程却常常让人头疼不已。从环境配置到版本兼容，从依赖库的缺失到编译错误的排查，每一个环节都可能成为开发路上的"拦路虎"。本文将为你详细解析Qt编译过程中常见的问题，并提供实用的解决方案，让你轻松应对各种编译挑战。

在Windows平台上，Visual Studio（VS）是许多开发者首选的开发工具。然而，当Qt与VS相遇时，却常常出现一些令人困扰的问题。下面，我们将详细介绍如何在VS中顺利编译Qt项目。

安装与配置

首先，确保你已经正确安装了Qt和Visual Studio。在VS中使用Qt，需要借助Qt VS Tools插件。安装步骤如下：

1. 打开VS，选择"扩展"->"管理扩展"
2. 在扩展市场中搜索"Qt Visual Studio Tools"
3. 安装插件后重启VS

安装完成后，你可以在工具栏中看到Qt VS Tools的选项。接下来，需要配置Qt版本：

1. 打开Qt VS Tools的下拉菜单，选择"Qt Versions"
2. 点击"Add"按钮，选择你的Qt qmake.exe路径

从Qt4到Qt5的升级

许多开发者在从Qt4升级到Qt5时会遇到兼容性问题。以下是一些常见的解决方案：

• 成员函数弃用：Qt5中许多Qt4的成员函数已被弃用。解决方法是在代码中使用QT_DEPRECATED宏，或者直接替换为Qt5推荐的函数。

• 编译错误：如果遇到类似"undefined reference"的错误，很可能是由于Qt版本不匹配。确保你的项目配置和使用的Qt库版本一致。

• 环境变量配置：有时需要手动设置环境变量。例如，将Qt库路径添加到LD_LIBRARY_PATH中：

  export LD_LIBRARY_PATH=/path/to/your/qt/lib:$LD_LIBRARY_PATH
  

具体编译步骤

以Qt5.8.0为例，使用VS2015编译的步骤如下：

1. 下载带源码的安装包（如qt-opensource-windows-x86-msvc2015_64-5.8.0.exe）
2. 安装源码到指定目录
3. 使用Qt VS Tools打开${Root}/src/qtbase/src/src.pro
4. 配置项目并生成解决方案
5. 编译项目

如果遇到"Could not find feature libatomic"的错误，可以尝试以下解决方案：

• 确保Perl已正确安装并添加到系统路径
• 使用VS命令行工具运行configure.bat
• 手动添加缺失的库文件

命令行示例

./configure.bat -force-debug-info
nmake

其中-force-debug-info参数用于编译带调试信息的release版本。

在Linux环境下，Qt的编译通常需要进行交叉编译，以适配不同的硬件平台。下面以Qt5.15.10为例，介绍完整的编译流程。

环境准备

1. 获取开发板对应的交叉编译链，并将其安装到系统中（通常是拷贝到某个目录并配置环境变量）

2. 安装必要的依赖库：

sudo apt-get install libxcb*
sudo apt-get install libxkbcommon*

3. 下载Qt源码和QtCreator：

• Qt源码：https://download.qt.io/archive/qt/5.15/5.15.10/single/
• QtCreator：https://download.qt.io/archive/qtcreator/4.15/4.15.0/

安装QtCreator

1. 执行安装命令：

./qt-creator-opensource-linux-x86_64-4.15.0.run

2. 将QtCreator添加到系统快捷方式：

• 打开Ubuntu的右下角九个点菜单
• 找到"Qt Creator"
• 右键点击，选择"Add to Favorites"

3. 解决QtCreator启动问题：

• 编辑~/.bashrc文件，添加export QT_DEBUG_PLUGINS=1
• 执行source ~/.bashrc使其生效

交叉编译Qt源码

1. 解压交叉编译链到/usr/local/aarch64-linux-gnu

2. 配置环境变量：

export PATH="/usr/local/aarch64-linux-gnu/bin:$PATH"
export LD_LIBRARY_PATH="/usr/local/aarch64-linux-gnu/lib:$LD_LIBRARY_PATH"

3. 配置Qt：

../qt-everywhere-src-5.15.10/configure -xplatform linux-aarch64-gnu-g++ -prefix /path/to/install

4. 编译并安装：

make
make install

解决版本冲突

如果系统中存在多个Qt版本，可能会出现类似"version `Qt_5.12' not found"的错误。解决方法如下：

1. 检查系统默认Qt库路径：

ls /usr/lib/x86_64-linux-gnu/

2. 配置环境变量：

export QTDIR=/path/to/your/qt
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

3. 更新default.conf文件：

sudo vim /usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf

添加Qt安装目录路径。

4. 检查Qt版本：

qmake --version

在Qt编译过程中，经常会遇到一些令人头疼的错误。下面列举了一些常见的错误及其解决方案：

1. JSON解析错误

Error 5 while parsing C:/qt-everywhere-src-6.6.2/qt-build/qtdeclarative/src/qmlmodels/meta_types/qt6qmlmodels_release_metatypes.json: illegal value

解决方法：检查.json文件是否为空，如果为空，添加"[]"内容。

2. 链接错误

undefined reference to `_imp___ZN12QApplicationC1ERiPPci'

这通常是由于Qt版本不匹配导致的。确保你的项目配置和使用的Qt库版本一致。

3. 环境变量未配置

如果遇到找不到库文件的错误，很可能是环境变量未正确配置。确保已将Qt库路径添加到LD_LIBRARY_PATH中。

4. 依赖库缺失

如果提示缺少特定的库文件（如libX11），需要安装相应的开发库：

sudo apt-get install libx11-dev

当遇到棘手的编译问题时，Google搜索往往是解决问题的关键。以下是一些实用的搜索技巧：

1. 精确搜索：使用双引号包围关键词，进行精确匹配。例如："Qt5 undefined reference"

2. 搜索特定网站：使用site:域名，限定搜索范围。例如：site:stackoverflow.com Qt5编译错误

3. 查看官方文档：Qt官方文档是解决问题的重要资源。例如：https://doc.qt.io/qt-6/windows-building.html

4. 参与社区讨论：在Qt官方论坛或Stack Overflow上提问，往往能获得专业的解答。

通过不断实践和搜索，你将逐渐掌握Qt编译的精髓，成为一名更加出色的开发者。记住，每个编译错误都是一个学习的机会，不要害怕失败，勇敢地面对挑战吧！