如何安装Qt并配置开发环境，Qt安装教程及配置怎么做

Qt 是目前跨平台桌面应用开发的首选框架，但其安装配置的复杂性常让新手却步。最稳妥的安装路径是：选择开源版、匹配编译器、配置好构建套件（Kit）、验证运行环境，只要按此主线执行，十分钟内即可完成标准开发环境搭建，本文提供基于 Windows 11 环境的完整实操方案，并给出结合酷番云云主机的独家配置经验。

安装前的核心决策

选择 Qt 版本

• 长期稳定版优先：推荐 Qt 5.15.2 或 Qt 6.5 LTS，5.15 对旧项目兼容性好，6.5 支持高性能渲染和更现代的 C++ 标准。
• 避免使用 RC 或 Alpha 版，除非你需要测试新特性。

选择编译器

• Windows 下推荐 MSVC 2019/2026（与 Visual Studio 配套）或 MinGW 11.2（无需安装 VS）。
• 若你后续要使用 Qt WebEngine 或 QML 高级模块，MSVC 是必选项；若只是桌面控件开发，MinGW 更轻量。

选择安装组件

• 必选：Qt 核心模块（Qt Core、Qt GUI、Qt Widgets）、对应编译器的调试符号、Qt Creator IDE。
• 建议勾选：Qt Charts、Qt Data Visualization、Qt Script（5.x 才需要单独选）。
• 磁盘规划：完整安装约需 15-20 GB，建议安装在非系统盘（如 D:Qt）。

完整安装步骤（Windows 环境）

下载在线安装器

• 访问 Qt 官网下载 qt-online-installer-windows-x64-x.x.x.exe。
• 注意：必须注册 Qt 账号，选择开源版本并同意 LGPLv3 协议。

安装过程中的关键设置

• 安装目录：不要包含中文和空格，D:QtQt6.5.3。
• 组件选择：勾选 Qt 6.5.3 下的 MSVC 2019 64-bit 和 MinGW 11.2.0 64-bit，同时勾选 Qt Creator 和 附加库（如 Qt Multimedia）。
• 建议同时勾选 Qt Debug and Release Tools，避免后续缺少调试器。

配置 Qt Creator

• 打开 Qt Creator → 工具 → 选项 → Kits。
• 若编译器未自动识别,手动添加：
  • MSVC：选择 C:Program FilesMicrosoft Visual Studio2026CommunityVCToolsMSVC...binHostx64x64cl.exe
  • MinGW：选择 D:QtToolsmingw1120_64bing++.exe
• 在 Kit 中设置 Qt 版本 路径为 D:QtQt6.5.36.5.3mingw_64qmake.exe。
• 重点验证：点击 “Configure” 后确保每个 Kit 显示绿色对勾，且 CMake 和 Ninja 已自动找到。

环境变量与系统级配置

添加环境变量

• 将 D:QtQt6.5.36.5.3mingw_64bin 和 D:QtToolsmingw1120_64bin 加入系统 PATH。
• 目的：让命令行和第三方工具能直接调用 qmake、windeployqt 等 Qt 工具。

验证安装是否成功

• 用命令行输入 qmake --version，应输出 QMake version 3.1 和 Qt 版本号。
• 在 Qt Creator 新建一个 Qt Widgets Application，直接编译运行

  

  ，弹出空白窗口即表示环境正常。

酷番云云产品实战经验（独家案例）

当你在本地完成 Qt 安装后，如果团队协作或多环境测试需求，推荐使用酷番云高性能云主机作为远程编译与测试服务器，我们的实际案例：

• 场景：为一个金融客户开发跨平台交易终端，本地 Windows 环境无法模拟 Linux 下的字体渲染和网络行为。
• 方案：在酷番云开通一台 4核8GB 的 Ubuntu 22.04 云主机，安装同样的 Qt 5.15.2 交叉编译环境。
• 操作要点：
  1. 通过 SSH 连接，用 sudo apt install qt5-default libqt5svg5-dev 安装基础库。
  2. 配置 Qt Creator 的 Remote Compilation 插件，将本机代码同步到云主机。
  3. 利用酷番云的内网高速网络,编译速度比本地高 30% 以上，且避免了 Windows 下路径含中文导致的构建失败问题。
• 收益：一键在云主机生成 Linux 部署包，并直接内置在酷番云对象存储中分发给测试团队。强烈建议所有涉及多平台发布的 Qt 开发者，将云端作为第二编译节点，能节约大量本地排查时间。

常见问题与专业解决方案

编译报错 cannot find -lGL

• 原因：Linux 下缺少 OpenGL 库。
• 解决：sudo apt install libgl1-mesa-dev。

Qt Creator 无法识别 Kits

• 检查：是否安装了对应的编译器组件。



• 解决：重新运行 Qt 安装器，勾选缺失的编译器和调试源码。

部署时缺少 DLL

• 核心方法：使用 Qt 自带的 windeployqt 工具。
• 示例命令：windeployqt D:buildMyApp.exe，该工具会自动复制所有依赖 Qt DLL 到可执行文件目录。

相关问答模块

问题1：Qt 安装时提示“没有写入权限”怎么办？

解答：不要将 Qt 安装到 C:Program Files 目录下，该目录受 Windows UAC 保护，普通权限无法写入，正确做法是选择 D 盘或其他用户完全控制的目录，若已安装失败，右键安装程序选择“以管理员身份运行”，但这只是临时方案，建议始终使用自定义目录。

问题2：MinGW 和 MSVC 编译出的程序有什么区别？

解答：MSVC 编译出的程序依赖 Microsoft Visual C++ 运行库，且与 VS 生态兼容性最好，适合需要混合编程或调试复杂内存问题的场景，MinGW 使用 GCC 编译器，程序更轻量，且可独立分发无需额外运行库，但对 Windows 底层 API 的封装表现略有不同，如果你不需要使用 Windows SDK 的特殊功能，MinGW 完全够用且更容易部署。

互动：你在 Qt 安装或配置中遇到过最棘手的问题是什么？欢迎在下方评论区留言，我会抽取典型问题在下期文章中给出实操排查方案，若本文对你有帮助，请点赞或收藏，支持我持续输出更多 Qt 实战干货。