Qt5.12 + VS2022 完整配置方案

张开发
2026/5/1 7:10:34 15 分钟阅读

分享文章

Qt5.12 + VS2022 完整配置方案
好的给你一套能稳定跑的 Qt 5.12 VS2022 完整配置方案实战可用我会把坑点一起讲清楚避免你踩雷。⚠️ 先说结论非常重要Qt 5.12 不原生支持 VS2022MSVC2022✔ 正确方案是Qt 5.12 MSVC2019 编译器 VS2022 IDE也就是用 Visual Studio 2022 写代码但用MSVC2019工具链编译 Qt一、准备环境1️⃣ 安装 VS2022如果你还没完整装打开 VS Installer确保安装✔ 工作负载“使用 C 的桌面开发”✔ 单独组件关键MSVC v142VS2019工具集Windows 10 SDK建议 10.0.190412️⃣ 安装 Qt 5.12来自 Qt Company 官方安装器选择组件重点必须选Qt 5.12.x → MSVC 2019 64-bit不要选❌ MSVC2017除非你装了❌ MinGW除非你不用 VS二、安装 Qt VS 插件在 VS2022 里 扩展 → 管理扩展安装Qt Visual Studio Tools实体Qt Visual Studio Tools安装后重启 VS三、配置 Qt 到 VS20221️⃣ 打开 Qt 配置菜单Qt VS Tools → Qt Options2️⃣ 添加 Qt 版本点击 Add路径填D:\Qt\5.12.12\msvc2019_64你的实际路径3️⃣ 设置默认 Qt 版本选中刚添加的版本 → Set as Default四、创建 Qt 项目验证方法1推荐文件 → 新建 → 项目 → Qt Widgets Application方法2如果没模板 说明插件没生效解决重启 VS或重新安装插件五、关键工具链选择最容易错创建项目后 右键项目 → 属性确认平台工具集v142VS2019⚠️ 如果是 v143VS2022会出问题六、运行测试代码#include QApplication #include QPushButton int main(int argc, char *argv[]) { QApplication a(argc, argv); QPushButton btn(Hello Qt5.12 VS2022); btn.show(); return a.exec(); }运行成功说明配置OK ✅七、常见错误 解决重点❌ 1. LNK2038 / CRT mismatch原因 混用了 v142 和 v143解决统一用 v142❌ 2. 找不到 Qt 头文件fatal error C1083原因 Qt 未正确关联解决重新设置 Qt Version重新运行 qmake❌ 3. Qt Creator能用 VS不能用原因 VS没绑定 Qt解决 Qt VS Tools → 重新配置❌ 4. moc / uic 错误原因 没走 Qt 构建流程解决右键项目 → Qt → Run qmake❌ 5. 程序运行闪退原因 缺少 Qt DLL解决windeployqt.exe your.exe八、进阶推荐你这样做✔ 用 CMake更现代Qt 5.12 支持find_package(Qt5 COMPONENTS Widgets REQUIRED) add_executable(app main.cpp) target_link_libraries(app Qt5::Widgets) VS2022 对 CMake 支持更好九、最佳实践给你总结项目推荐IDEVS2022编译器MSVC2019 (v142)Qt版本5.12.12构建方式Qt VS Tools 或 CMake

更多文章