Visual Studio 2019无法识别Qt 6.1.2头文件如<QApplication>的问题如何解决

问题原因 #

你遇到的头文件识别问题本质是项目的附加包含路径缺少Qt对应模块的子目录。Qt的类名头文件（比如QApplication）存放在对应模块的子目录下（如QtWidgets/QApplication），只有把模块子目录也加入包含路径，才能直接用#include <QApplication>的写法。

解决方案 #

• 第一步：检查Qt模块勾选配置
  右键项目名称，依次选择Qt -> Qt Project Settings，切换到Modules标签页，确认已勾选基础必备模块：Core、Gui、Widgets，用到其他功能（如网络、多媒体）时再勾选对应模块。勾选后Qt VS Tools会自动将对应模块的头文件目录加入项目配置。

• 第二步：手动验证/补充包含路径
  如果勾选模块后问题仍存在，右键项目名称选择属性，依次进入C/C++ -> 常规 -> 附加包含目录，确认配置中存在以下格式的路径（以Qt 6.1.2 msvc2019_64版本为例）：

  你的Qt安装路径\6.1.2\msvc2019_64\include
  你的Qt安装路径\6.1.2\msvc2019_64\include\QtCore
  你的Qt安装路径\6.1.2\msvc2019_64\include\QtGui
  你的Qt安装路径\6.1.2\msvc2019_64\include\QtWidgets
  

  配置时注意顶部的配置选择所有配置，平台选择所有平台，避免仅对单环境生效。

• 第三步：修复智能感知缓存
  如果修改后编译可以正常通过，但VS编辑器仍标红提示找不到头文件，点击顶部菜单栏项目 -> 重新扫描解决方案，刷新智能感知缓存即可消除错误提示。

附加说明 #

QCoreApplication是Qt无GUI程序的入口类，QApplication是Qt Widgets GUI程序的专用入口类，二者功能不同，开发Widget程序不能用前者替代后者。

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