如何在Visual Studio IDE中配置Qt 6.6.0开发C++ GUI程序？

1. 安装Qt Visual Studio Tools插件 #

• 打开Visual Studio，进入「扩展」→「管理扩展」，搜索「Qt Visual Studio Tools」下载安装，完成后重启VS。

2. 配置对应Qt版本 #

• 重启VS后，点击顶部菜单栏「Qt VS Tools」→「Qt Options」。
• 点击「Add」，选择C盘Qt 6.6.0目录下的msvc2019_64文件夹（路径示例：C:\Qt\6.6.0\msvc2019_64），添加后将其设为默认版本。

3. 配置项目（新项目/现有项目） #

新项目创建 #

• 选择「创建新项目」，搜索「Qt Widgets Application」，按照向导选择已配置的msvc2019_64版本完成创建。

现有项目配置 #

• 右键项目→「属性」，在「Qt Project Settings」中确认「Qt Version」选中msvc2019_64。
• 进入「C/C++」→「常规」→「附加包含目录」，手动添加以下路径（若未自动生成）：
  • C:\Qt\6.6.0\msvc2019_64\include
  • C:\Qt\6.6.0\msvc2019_64\include\QtCore
  • C:\Qt\6.6.0\msvc2019_64\include\QtWidgets

4. 验证配置 #

• 在main.cpp中写入测试代码：

#include <QCoreApplication>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QWidget w;
    w.show();
    return a.exec();
}

• 编译运行，若无头文件相关报错则配置成功。

5. 关键注意事项 #

• 确保VS版本与Qt的MSVC版本兼容：msvc2019_64对应Visual Studio 2019及以上版本（2022兼容）。
• 修正QTDIR环境变量：需指向C:\Qt\6.6.0\msvc2019_64而非Qt根目录，修改后重启VS生效。
• 清理缓存：右键项目→「清理」，再「生成解决方案」，避免旧缓存干扰。

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