Qt新手避坑指南：编译不再踩雷

Qt新手避坑指南：编译不再踩雷

引用

CSDN

等

9

来源

1.

https://blog.csdn.net/sincere_ly_/article/details/136715362

2.

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

3.

https://blog.csdn.net/doubleintfloat/article/details/140789215

4.

https://blog.csdn.net/chenjianqi0502/article/details/77334710

5.

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

6.

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

7.

https://blog.csdn.net/qq_44833254/article/details/136802821

8.

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

9.

https://docs.oldtimes.me/c.biancheng.net/view/3997.html

对于Qt新手开发者来说，编译错误往往是遇到的第一个也是最大的挑战。这些错误不仅会打断开发进度，还可能因为其复杂性而让初学者感到沮丧。本文将介绍Qt开发中常见的编译错误及其解决方案，并分享一些实用的开发建议，帮助新手开发者顺利度过这一阶段。

常见编译错误及解决方案

1. MSB3073错误

错误示例：

错误 4 error MSB3073: 命令“\bin\rcc.exe” --list “heavyicing.qrc” > “E:\cccc\SmartTools\src…\temp\Debug\rcc_list.txt” 2> nul”已退出，代码为 3。

错误原因：这个错误通常是由于项目配置文件（.user文件）存在问题，与Git仓库中的版本不一致导致。

解决方案：

1. 打开记事本，将运行成功的项目的.user文件内容复制到出错项目的.user文件中。
2. 确保.user文件中包含正确的Qt版本信息。

2. 无法解析的外部符号

错误示例：

LNK2019: 无法解析的外部符号 "public: __cdecl MyClass::MyClass(void)" (??0MyClass@@QEAA@XZ)，函数 main 中引用了该符号

错误原因：这类错误通常由以下几种情况引起：

• 缺少必要的库文件
• 声明与定义不一致
• 编译顺序问题
• 项目配置错误

解决方案：

1. 检查库文件：确保所有使用的外部库都已正确添加到项目中。
2. 检查声明与定义：确保函数和变量的声明与定义完全一致。
3. 调整编译顺序：在多文件项目中，确保符号定义在使用前已被编译。
4. 检查项目配置：确认链接器设置正确，所有必要库文件都已添加。

3. D3D12CreateDevice相关错误

错误示例：

error: '_uuidof' was not declared in this scope

解决方案：

1. 在相关源文件中添加必要的头文件，如d3d12sdklayers.h。
2. 将_uuidof替换为__uuidof。
3. 检查并调整变量声明，确保使用static inline关键字。

新手开发注意事项

1. 正确处理大量错误

当编译出现大量错误时，不要急于查看所有错误信息。通常，第一个错误是问题的根源，解决它后，后续的错误往往会自动消失。例如，一个简单的语法错误可能导致编译器产生数百个错误提示，但只需修正这一个错误，其他错误就会消失。

2. 合理使用定时器

定时器是Qt中非常实用的功能，可以帮助优化程序性能。例如，在窗体初始化时执行耗时操作很容易导致界面卡顿。通过使用单次定时器或异步调用，可以避免这种情况：

// 异步执行load函数
QMetaObject::invokeMethod(this, "load", Qt::QueuedConnection);

// 延时10毫秒执行load函数
QTimer::singleShot(10, this, SLOT(load()));

3. 配置多线程编译

默认情况下，Qt Creator使用单线程编译，这可能无法充分利用现代多核处理器的性能。建议手动配置多线程编译：

• 方法一：在每个项目的构建设置中增加-j16参数（根据CPU核心数调整）。
• 方法二：在构建套件的环境中设置MAKEFLAGS=-j4，这样所有使用该套件的项目都会自动应用多线程编译。

4. 关注Qt版本兼容性

确保使用的Qt版本与编译器版本兼容。例如，从Qt 5升级到Qt 6时，需要注意API的变化。同时，如果需要在不同操作系统上部署程序，要确保所有平台的库文件都已正确配置。

5. 学会使用Qt的元对象系统

Qt的元对象系统提供了强大的反射功能，可以用于获取类的属性和方法。例如：

const QMetaObject *metaObject = widget->metaObject();
int propertyCount = metaObject->propertyCount();
int propertyOffset = metaObject->propertyOffset();

for (int i = propertyOffset; i < propertyCount; ++i) {
    QMetaProperty metaProperty = metaObject->property(i);
    const char *name = metaProperty.name();
    const char *type = metaProperty.typeName();
    qDebug() << name << ":" << type;
}

通过掌握这些基础知识和技巧，Qt新手开发者可以更从容地面对开发过程中的各种挑战。记住，编译错误并不可怕，它们是学习和进步的必经之路。随着经验的积累，你会越来越熟练地处理这些问题，最终成为一名优秀的Qt开发者。