Qt编译错误？这些坑你踩过吗？

Qt编译错误？这些坑你踩过吗？

引用

CSDN

等

8

来源

1.

https://blog.csdn.net/BJ4015/article/details/140711732

2.

https://blog.csdn.net/qq_28742901/article/details/136251150

3.

https://cloud.baidu.com/article/3232943

4.

https://blog.csdn.net/Hat_man_/article/details/144632067

5.

https://blog.csdn.net/SteveForever/article/details/140886643

6.

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

7.

https://juejin.cn/post/7354632375445356571

8.

https://www.cnblogs.com/ybqjymy/p/18037680

在Qt开发过程中，编译错误是开发者经常遇到的挑战。从环境配置到代码实现，从版本选择到兼容性问题，Qt的复杂性往往让开发者感到头疼。本文将结合具体案例，总结Qt编译中常见的错误及其解决方案，帮助开发者避开这些"坑"。

在Qt 5.6.1中，有开发者发现缺少libqgif.a和libqjpeg.a这两个库文件。这两个文件与GIF和JPEG图像格式支持相关，缺失会导致相关功能无法正常使用。

原因分析

1. 缺少必要的插件：确保在项目中正确导入了QGifPlugin和QJpegPlugin。可以在代码中添加以下内容：

   #include <QtPlugin>
   Q_IMPORT_PLUGIN(QGifPlugin)
   Q_IMPORT_PLUGIN(QJpegPlugin)
   

2. .pro文件配置错误：检查你的.pro文件是否包含以下行以确保加载相应的插件：

   QTPLUGIN += qgif qjpeg
   

3. 清理并重新构建项目：删除中间构建文件后重新编译，避免缓存问题影响结果。

4. 确认编译选项：在静态编译Qt时，需要通过configure脚本启用相关功能。例如，使用以下命令可以确保包含GIF和JPEG支持：

   ./configure -static -prefix /path/to/install -qt-gif -qt-libpng -qt-libjpeg ...
   

5. 验证第三方库：确认-qt-zlib, -qt-libpng, 和 -qt-libjpeg是否已正确链接到Qt，因为它们是处理图像格式的基础依赖。

如果以上步骤未能解决问题，请提供更多详细的编译日志或错误信息，以便进一步排查。

1. D3D12相关错误

在使用MSYS2编译32位Qt源码时，可能会遇到以下错误：

HRESULT hr = D3D12CreateDevice(adapter.Get(), fl, _uuidof(ID3D12Device), nullptr);
error: '_uuidof' was not declared in this scope

解决方案：

1. 编译路径查找src/plugins/scenegraph/d3d12/qsgd3d12engine.cpp
2. 将__uuidof替换为_uuidof
3. 查找src/plugins/scenegraph/d3d12/qsgd3d12engine_p_p.h
4. 添加#include <d3d12sdklayers.h>（路径：C:\msys64\mingw32\include）
5. 将static const int MAX_SWAP_CHAIN_BUFFER_COUNT = 4;static const int MAX_FRAME_IN_FLIGHT_COUNT = 4;替换为static inline const int MAX_SWAP_CHAIN_BUFFER_COUNT = 4;static inline const int MAX_FRAME_IN_FLIGHT_COUNT = 4;

2. 信号槽参数不匹配

编译时代码没有提示错误的地方，但报错在Qt的文件中，提示"信号提供的参数比槽函数需要的少"。例如：

The slot requires more arguments than the signal provides.

解决方案：检查信号和槽函数的参数列表，确保它们匹配。注意，信号槽一多就很难排查，建议在编码时就仔细检查参数列表。

3. "无法解析的外部符号"错误

这类错误源于编译器在链接阶段未能找到某些已声明或引用的符号的定义。常见原因包括：

• 未包含必要的库文件
• 声明与定义不一致
• 编译顺序问题
• 项目配置问题

解决方案：

1. 确保所有外部库文件都被正确添加进项目中
2. 检查符号的声明和定义是否完全一致
3. 调整文件的编译顺序
4. 检查链接器设置是否正确
5. 查看编译器和链接器的输出信息

4. .pro.user文件问题

有时候会遇到"no executable specified"的错误。解决方案很简单：进入编译目录，删除.pro.user文件，然后重新编译。

5. C++17支持问题

在使用Qt 6.3.0和MSVC2019 64bit时，可能会遇到以下错误：

Qt requires a C++17 compiler, and a suitable value for __cplusplus. On MSVC, you must pass the /Zc:__cplusplus option to the compiler.

解决方案：在pro文件中添加以下内容：

QMAKE_CXXFLAGS += -std:c++17 -Zc:__cplusplus -permissive- option

如果遇到"Unexpected compiler version"的错误，可能需要修改宏定义：

#define _MSC_VER 1922

除了编译错误，Qt开发中还存在一些常见的坑点：

1. 版本选择：Qt版本众多，从4.6到6.8，每个版本都有其特点。选择合适的版本对项目成功至关重要。

2. 乱码问题：尤其是在Qt4时代，各种乱码问题困扰开发者。幸运的是，从Qt5开始，乱码问题已经大大减少。

3. 接口变动：Qt的版本更新带来了大量的接口变动，让开发者需要不断学习和适应。

4. 打包发布：Qt项目的发布相对复杂，需要处理大量的运行库文件。使用deployqt工具可以简化这一过程。

5. 兼容性问题：虽然Qt追求跨平台兼容性，但在高分屏缩放、qml兼容性等方面仍存在不少问题。

1. 环境配置：确保开发环境配置正确，包括编译器版本、库文件路径等。

2. 代码检查：编写代码时就仔细检查信号槽连接、函数声明和定义等，避免后期排查。

3. 版本管理：选择稳定的Qt版本，不要盲目追求最新版本。

4. 错误日志：遇到问题时，仔细查看编译器和链接器的输出信息，这些信息往往能提供重要线索。

5. 社区资源：充分利用Qt社区资源，包括官方文档、论坛和开源项目。

通过以上方法，可以有效避免和解决Qt开发中的各种问题，提高开发效率和代码质量。