无法构建Qt项目：编译报错求助（Qt 6.4.1）

从代码仓库克隆的Qt项目，在Qt 6.4.1版本的Qt Creator中构建时出现大量编译错误，具体错误包括：

Unknown type name 'QString'
Unknown type name 'QSqlDatabase'
Unknown type name 'Q_OBJECT'
'QWidget' file not found

项目原开发者可正常运行，推测问题出在Qt Creator配置或.pro文件中，当前使用的.pro文件内容如下：

QT       += core gui
QT       += sql

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

CONFIG += c++17

# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0

SOURCES += all necessary .cpp files\

HEADERS += all necessary .h files\

FORMS += all necessary .ui files\
    

# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

• 检查Qt Kit配置
  打开Qt Creator的工具 > 选项 > 构建和运行 > Kits，确认当前使用的Kit对应Qt版本为6.4.1，且已正确安装qtbase（包含core、gui、widgets模块）和qtsql模块。若Kit配置为其他Qt版本，切换至正确的6.4.1 Kit。
• 重新生成构建文件
  在Qt Creator中右键项目，选择运行qmake，随后执行清理项目和构建项目。克隆项目后残留的旧构建缓存可能导致头文件路径识别错误。
• 调整.pro文件的Qt模块引用
  Qt 6中widgets模块不再包含在gui内，虽然现有.pro中的版本判断逻辑正确，但可直接改为明确引用，避免潜在问题：

  QT       += core gui widgets sql
  

• 验证头文件配置
  检查项目头文件，确保正确添加#include <QString>、#include <QSqlDatabase>、#include <QWidget>，无拼写错误。带Q_OBJECT宏的头文件必须已加入.pro的HEADERS列表，且项目已运行qmake生成moc文件。
• 确认编译器兼容性
  检查Kit使用的编译器（如GCC/Clang/MSVC）与Qt 6.4.1兼容，且编译器路径配置正确。版本不匹配的编译器可能导致头文件无法被识别。

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