使用Qt VS Tools时如何修复LNK2019链接错误

我尝试在Visual Studio中创建一个简单的Qt应用程序，已确保安装了所有Qt组件。

代码如下： #

#include "QtWidgetsApplication2.h"
#include <QtWidgets/QApplication>

#include <QtDataVisualization/Q3DSurface>
#include <QtDataVisualization/QSurfaceDataProxy>
#include <QtDataVisualization/QHeightMapSurfaceDataProxy>
#include <QtDataVisualization/QSurface3DSeries>
#include <QtWidgets/QSlider>


int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QtWidgetsApplication2 w;

    Q3DSurface* graph = new Q3DSurface();
    QWidget* container = QWidget::createWindowContainer(graph);

    w.show();
    return a.exec();
}

我已设置正确的Qt版本，并为链接器指定了额外库路径（C:\Qt\6.4.0\msvc2019_64\lib），但仍出现LNK2019链接错误，请问原因是什么？

补充说明：
我的.pro文件内容：

TEMPLATE = app
TARGET = QtWidgetsApplication2
DESTDIR = ../x64/Debug
CONFIG += debug
DEPENDPATH += .
MOC_DIR += .
OBJECTS_DIR += debug
UI_DIR += .
RCC_DIR += .
include(QtWidgetsApplication2.pri)

• 未声明Qt Data Visualization模块依赖：你代码里用到了QtDataVisualization模块的类（比如Q3DSurface），但.pro文件里没添加该模块。Qt可视化模块属于额外模块，必须明确声明才能让链接器找到对应库。
  解决：在.pro文件中添加一行QT += datavisualization，QMake会自动处理库的引入。

• 调试库匹配问题：Debug模式下需要链接带d后缀的调试版库（比如Qt6DataVisualizationd.lib），如果手动指定库时没选对，或者QMake没自动引入，就会报错。
  解决：添加上述模块依赖后，QMake会自动引入对应Debug版本的库，无需手动添加；如果手动配置链接器输入，要确保选的是带d后缀的调试库。

• 编译器与Qt版本不匹配：你用的是MSVC2019_64的Qt，必须确保Visual Studio用的是对应版本的64位MSVC编译器（工具集为Visual Studio 2019 (v142)），版本不兼容会导致链接失败。
  解决：在Visual Studio的项目属性里，切换平台为x64，确认工具集选择正确。

• .pri文件配置缺失：你引入了QtWidgetsApplication2.pri，如果这个文件里没添加QT += widgets这类必要模块，或者覆盖了库路径配置，也会引发问题。
  解决：打开.pri文件检查，确保它包含了项目需要的Qt模块，且没有错误覆盖库相关配置。

内容的提问来源于stack exchange，提问作者IRP_HANDLER