当前位置： 首页 > article >正文

【保姆级图文教程】QT下载、安装、入门、配置VS Qt环境

article 2024/11/22 21:44:29

目录

  • 0.前言
    • 说明
    • Qt介绍
    • 其他
  • 1.下载安装QT
  • 2.创建并编写第一个Qt程序
  • 3.配置Visual Studio编写Qt程序的环境
  • 补充
    • 补充一：仅选择必要部分安装
    • 补充二：后期添加未安装的模块
    • 补充三：Visual Studio插件安装
    • 补充四：通过命令行窗口打开安装程序
    • 补充五：离线方式安装老版本（5.14.2为例）

0.前言

说明

本文内容充实细致，话多但是没有多余。如果你需要在Windows系统安装Qt并入门使用，这是一篇很好的博客，请耐心看完，有疑问欢迎评论或者私信。

Qt介绍

QT 是一个跨平台的应用程序开发框架，它提供了丰富的工具和类库，用于开发图形用户界面（GUI）程序。Qt 提供了 C++ 编程语言接口，同时也支持其他编程语言，如 Python和QML。
以下是 QT 的一些主要特点：

  1. 跨平台：Qt 支持在多个操作系统上进行开发，包括 Windows、macOS、Linux、Android 和 iOS 等。通过编写一次代码，可以在不同平台上进行部署和运行。
  2. 高度集成的开发环境：Qt 提供了 Qt Creator，一个集成的开发环境，用于代码编辑、调试和界面设计。它提供了丰富的工具和可视化设计器，使开发过程更加高效。注意：Qt是一个应用程序开发框架，Qt Creator则是其提供的一个IDE，注意区分
  3. 强大的图形用户界面库：Qt 的 GUI 框架提供了丰富的 UI 控件和布局管理器，使开发者可以轻松创建各种功能齐全的界面。同时，Qt 还支持自定义样式和主题，使界面能够与平台和用户需求相适应。
  4. 响应式编程：Qt 引入了信号与槽机制，用于在对象之间进行通信和事件处理。这种机制使得编写响应式的代码更加简单和直观。
  5. 数据库支持：Qt 提供了对多种数据库的支持，包括 MySQL、SQLite、PostgreSQL 等，使开发者能够方便地进行数据持久化和处理。
  6. 多媒体功能：Qt 提供了大量的多媒体功能接口，包括音频、视频、图像处理等，使开发者可以轻松地实现音视频播放、图像处理等功能。

其他

  • 本博客的初心是帮助小白快速入门搭建好Qt环境，减少环境搭建的烦恼。
  • 书写的过程中我在尽力的写得非常细致，减少大家的阅读困难。
  • 如果有错误、需要改进的地方欢迎大家评论或私信，我会尽可能的回复并纠正。
  • 如果环境搭建遇到困难或者报错，也欢迎评论或私信我（请详细描述问题或直接截图），我会尽可能帮助你。我的回复可能不及时，但一般都在几个小时内
  • 如果对您有帮助还请点赞收藏支持一下博主，感谢感谢！

1.下载安装QT

说明：
1. Qt的安装方式有两种：1、在线（推荐）；2、离线。在线安装稍麻烦，能安装5.15及之后的版本，便于安装多个版本在根目录下进行后期管理；离线安装更简单，能安装5.14及之前的版本，安装速度不依赖于网速，但不便于多个版本的统一管理。
2. 本文两种方法均提供，本节的方法为在线安装方法，离线安装可以参看《补充五》

  1. 进入官网
    去官网的目的是下载在线安装器，我这儿也提供了在线安装器的网盘分享链接，如果通过网盘链接下载了安装器就可跳转到后续打开在线安装器的步骤
    官网地址为：QT官网
    下载页面地址为：下载页面
    在线下载器的网盘分享链接：UC网盘分享链接、百度网盘分享链接

  2. 点击Download.Try.
    在这里插入图片描述

  3. 点击选择开源版
    在这里插入图片描述

  4. 下拉，点击Download the Qt Online Installer
    在这里插入图片描述

  5. 选择对应的版本并下载，我这儿下载Windows版本
    在这里插入图片描述

  6. 下载完成后，找到下载器所在的文件夹，确保下载器在该文件夹之后，点击鼠标右键，点击“在终端中打开”，这样就可以打开终端并使其工作目录在这个文件下。如果无法通过该方法打开终端可以查看后文《补充四》
    在这里插入图片描述

  7. 打开该终端之后执行一条启动命令。形如：
    在这里插入图片描述

  • 先别急着直接用，听我先解释清楚这个指令。
这个指令可以分为三个部分，上面我用绿色的线标注了


.\qt-online-installer-windows-x64-4.8.0.exe   这一部分表示我要启动一个程序，就是指定了启动的程序的路径，因为我已经让你的终端工作环境为下载器所在的目录，所以这儿使用的是相对路径（当然你也可以使用绝对路径，直接右键文件复制完整路径进行替换即可，这是很基本的知识，不会请自行上网）。

--mirror      这一部分表示执行这个指令的时候要使用一个参数，即通过镜像网站启动程序（这是因为国内访问镜像网站的速度比较快）

https://mirrors.ustc.edu.cn/qtproject/  这一部分就是镜像网站的网址（我这里提供了两个可以使用的镜像网站，如果后续下载的时候网速慢那么你可以返回这一步使用另一个网站启动程序试试）
  • 提供的两个镜像网站的网址分别如下（个人更推荐使用中科大的镜像网站）：
中国科学技术大学：https://mirrors.ustc.edu.cn/qtproject/
清华大学：https://mirrors.tuna.tsinghua.edu.cn/qt/
  • 程序员喜欢偷懒，所以我把指令的样例提供给你供你复制。但是请你认真斟酌这个指令的三个部分是否正确地符合你的情况（尤其是第一部分，因为你下载的下载器版本很可能和我不一样，那么这个时候需要你手动修改这一部分使其和你下载的版本号保持一致），这很重要！！
.\qt-online-installer-windows-x64-4.8.0.exe --mirror https://mirrors.ustc.edu.cn/qtproject/
  • 如果你出现“无法将“.\qt-online-installer-windows-x64-4.8.0.exe”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。”这样的错误，那90%概率你没认真看我写的解释，指令的第一部分不正确。

  1. 输入Qt账号并登录，如果没有的话可以注册一个，并不麻烦
    在这里插入图片描述

  2. 如图
    在这里插入图片描述

  3. 如图
    在这里插入图片描述

  4. 如图
    在这里插入图片描述

  5. 选择合适的文件夹安装
    整个路径一定不能包含中文字符、空格等
    在这里插入图片描述

  6. 如图勾选，点击筛选，这样可以看到很多可以下载的版本
    在这里插入图片描述

  7. 选择需要的版本进行下载，我的勾选如下
    注意：一般只需从Qt栏中选择一个对应版本，其他默认即可
    我这里选择了5.14.2下的所有库，但这样软件体积很大且对入门选手没什么用，大家可以参考《补充一》选择部分库进行安装
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述

  • 2024.08.27更：现在Qt已经不再提供5.14.2版本，最小的版本是5.15，大家可以也可以下载这个版本，各个小版本之间的差异不大。如果需要使用Qt6，那么我推荐下载6.5.3，这是一个长期支持版本，镜像库也比较完整，一般不会出错。如果下载其他版本，可能会因为镜像库内容不完整等原因导致后续下载过程中出现“无法下载存档”等提示信息对话框，这是有忽略按钮就点击忽略，没有则点击重试，重试无法解决就尝试直接关闭提示窗口，还是无法解决就放弃下载这个版本，转而下载6.5版本或5.15版本。如果这两个版本也有这个错误，那么放弃Qt（开玩笑的，博主目前没遇到过，如果大家遇到了就搜搜其他的教程吧）
  • 2024.11.07更：遇到“无法下载存档”问题还可以参考该博客：博客，即删除缓存后再重复该博客的步骤。

  1. 如图
    在这里插入图片描述

  2. 如图
    在这里插入图片描述

  3. 如图
    在这里插入图片描述

  4. 等待安装完成
    在这里插入图片描述

  5. 如图
    在这里插入图片描述

2.创建并编写第一个Qt程序

  1. 点击创建项目
    在这里插入图片描述
  2. 如图
    在这里插入图片描述
  3. 输入项目名称、选择项目路径、点击下一步
    注意：项目名称和项目路径不能包含中文符号、空格等
    在这里插入图片描述
  4. 选择构建工具
    qmake是Qt提供的构建工具，用于简化 Qt 项目的构建过程。
    CMake 是一个跨平台的开源构建工具，用于管理和构建 C++ 程序的软件项目。与 qmake 类似，CMake 的目标是简化跨平台软件项目的构建过程。
    Qbs，全称：Qt Build Suite，是由Qt官方提供的一个跨平台构建工具，用于构建和管理Qt和非Qt项目。它是Qt Creator集成开发环境（IDE）的一部分，但也可以独立使用。
    我这儿选择qmake
    在这里插入图片描述
  5. 选择基础类
    在这里插入图片描述
    我这儿选择QWidget
  6. 如图
    在这里插入图片描述
  7. 选择构建套件
    我们使用QtCreator编写时，选择MinGW对应的版本，例如我这儿选择MinGW 64位
    如果使用Microsoft Visual Studio编写Qt程序则选择MSVC的对应版本，这个后文有说明
    在这里插入图片描述
  8. 如图
    在这里插入图片描述
  9. 等待构建
    此时Qt Creator会开始构建项目，右下角有进度条可以看见，如果全部是绿色则说明构建成功
    在这里插入图片描述
  10. 运行项目
    此时我们点击左下角运行按钮，可以看见弹出一个窗口，说明项目成功运行，我们的环境安装没有问题
    在这里插入图片描述

3.配置Visual Studio编写Qt程序的环境

注意：
1、在进行这一步之前你首先要知道Visual Studio（本节后续称VS）是什么，如果当你看到此处时不知道这个问题的答案，那么你在看完本段注意事项之后就不用再看这一节了。
2、VS是微软公司旗下的一款功能十分强大的IDE，是市面上主流的C++语言IDE。我这一节的目的是给习惯使用VS进行C++项目开发的同学提供通过VS进行Qt、C++项目开发的环境配置教程，所以如果你现在不知道VS是什么那么你就使用Qt自带的Qt Creator进行项目开发，本节不再需要观看（当然你有兴趣也可以看下去）。
3、下文环境配置默认你已经安装好了VS，如果没安装可以查看我的另一篇关于VS的博客：【Visual Studio 新手入门指导】。

  1. 打开VS，在上方菜单栏找到并点击扩展->管理扩展
    在这里插入图片描述
  2. 如图
    在联机中搜索Qt，下载Qt Visual Studio Tools
    在这里插入图片描述
  3. 等待下载完成后关闭Visual Studio 所有窗口。如果下载过程太慢可以尝试《补充三》的方法
    在这里插入图片描述
  4. 此时会弹出一个窗口，点击Modify
    在这里插入图片描述
  5. 下载完成后点击Close
    在这里插入图片描述
  6. 再次打开Visual Studio，进入Qt Versions
    在这里插入图片描述
  7. 此时插件会自动检测已经安装的Qt套件（比如他就检查到我已经安装了6.5.2版本，如果没自动检查到也别担心，因为你能看到这儿来说明Qt安装是没问题的，照着下面的方法也可以手动添加Qt版本到这个插件），如果你还需要添加其他已经下载的版本，可以点击add new Qt version
    在这里插入图片描述
  8. 点击这个文件夹图标
    在这里插入图片描述
  9. 找到对应套件下的qmake.exe文件进行添加
    途中标识了这个文件的相对路径，可对照自己的Qt安装位置查找
    注意：在VS环境中就添加MSVC版本的套件，而不是MinGW套件
    在这里插入图片描述
  10. 点击确定完成，下面我们新建一个项目试试能否成功运行
    在这里插入图片描述
  11. 点击文件->新建->项目
    在这里插入图片描述
  12. 如图
    在这里插入图片描述
  13. 输入项目名称、位置、解决方案名称，点击创建
    我主页有博客介绍了VS如何创建有层次结构的解决方案、项目，大家可以看看，此处不再赘述
    在这里插入图片描述
  14. 此时弹出一个对话框，点击Next
    在这里插入图片描述
  15. 如图
  • 选择Debug，一般我们编写Qt程序时选择Debug进行创作，Release是发行版本
  • 选择对应的套件版本，注意是msvc的
  • 打勾
  • 选择Qt模块，一般初学时选择Core、Gui、Widgets即可
  • 点击Next
    在这里插入图片描述
  1. 如图
  • 进行一些项目信息的设置
  • 这儿我选择的基础类为QWidget，默认的QMainWindow也可以
    在这里插入图片描述
  1. 创建完成，点击运行
    出现这个窗口即成功创建好环境
    在这里插入图片描述

补充

补充一：仅选择必要部分安装

声明：对于存储空间充足的用户，仍然推荐下载完整的模块，避免后期造成不必要的麻烦
编译套件选择：推荐安装MSVC和MinGW的对应版本套件各一个，MSVC套件可以让你在Visual Studio下开发，MinGW可以让你在Qt Creator下开发，两个各选择一个版本以备使用，如下图所示。如果你是ARM架构芯片则选择ARM版本。
在这里插入图片描述
工具链选择：推荐选择一个最新版的MinGW工具链，如下图所示。
在这里插入图片描述
这一套选下来只要6GB，这样就大大减轻了硬盘压力。
在这里插入图片描述

补充二：后期添加未安装的模块

当在后期开发过程中发现部分功能模块在初始安装时没有安装，也可以借助Qt自带的维护工具快速补充安装，该工具还可以对一些已经安装的组件进行更新，操作方法如下：

  1. 进入Qt的安装目录，启动MaintenTool.exe工具
    安装目录就是你开始安装Qt的根目录。

    进入后可以找到这个MaintenTool.exe文件，双击启动它，如果在后续更新过程中发现网速太慢，同样可以用前文启动在线下载器时的方法启动MaintenTool.exe，如在终端依次执行如下命令：
    在这里插入图片描述
# 使终端工作环境为Qt根目录（需要根据自己的安装目录修改该命令）
cd E:\ProgramFiles\Qt

# 使用镜像网站启动MaintenanceTool.exe
.\MaintenanceTool.exe --mirror https://mirrors.aliyun.com/qt/
  1. 按照如下步骤操作
    如图：
    在这里插入图片描述
    如图：
    在这里插入图片描述
    勾选三个选项之后点击筛选，等待刷新完成。如图：
    在这里插入图片描述
    进入你需要安装的Qt的版本目录，例如我这儿需要更新的是Qt6.5.3的组件，找到需要更新的组件，根据自己的需求选择相应的组件，选择完毕之后点击下一步。如图：
    说明1：一般你缺少的一些模块在Additional Libraries里面就可以找到，需要什么就把他勾上。图中黄色方框框出了三个常用的模块，例如需要进行多媒体应用开发时（播放mp3音乐）就需要Qt MultiMedia模块。
    说明2：在你进入该目录时，你可能发现一些已有的组件已经被打上勾，如果你不是要卸载他们就不要取消打勾（因为这里打勾的含义是更新时候是否具有这些组件，而不是是否添加这些组件），因为取消后该维护工具会卸载他们。
    在这里插入图片描述
    如图：
    在这里插入图片描述
    等待更新完成。如图：
    在这里插入图片描述
    更新完成后点击下一步。如图：
    在这里插入图片描述
    点击完成或重新启动，至此完成更新。如图：
    在这里插入图片描述

补充三：Visual Studio插件安装

  • 如果在Visual Studio的插件商店下载Qt Visual Studio Tools网速太慢，可以尝试从这个链接下载插件进行安装：链接
    点击链接，选择一个比较新的版本号：
    在这里插入图片描述

  • 进入之后选择与自己的VS版本匹配的插件版本，例如intel芯片的VS2022可以选择下图版本的插件：
    在这里插入图片描述

  • 下载好之后你会得到这样一个.vsix插件安装文件：
    在这里插入图片描述

接下来正式开始插件安装，如果VS现在是打开的，那么需要先关闭VS

  • 双击启动该文件，如果启动时显示下图页面，则说明你下载的插件版本和VS的版本不匹配，那么可以回到前文重新寻找与VS版本匹配的插件版本进行下载
    在这里插入图片描述

  • 启动成功后如下图，选择要安装该插件的VS版本，点击Install：
    注意：在安装插件之前需要先关闭VS，否则会出现下列第二张图的情况，这时就点击End Tasks即可
    在这里插入图片描述
    在这里插入图片描述
    随后等待安装完成即可。

补充四：通过命令行窗口打开安装程序

  1. 打开命令行窗口
    • 法一：直接在安装程序所在的目录空白区域右击鼠标，在右键菜单点击“在终端打开”
      在这里插入图片描述
    • 法二：在Windows的搜索中输入Powershell，然后点击打开
      在这里插入图片描述
    • 法三：右击Windows开始菜单，点击“终端”
      在这里插入图片描述
  2. 设置终端当前工作路径
    解释：终端运行时有一个工作路径（工作目录）的概念，其只能识别该路径（目录）下的文件，所以我们在执行命令启动程序之前需要先设置终端的当前工作路径为安装程序所在的目录。
    • 终端打开默认的工作路径一般是C盘的某个路径，先确认默认的工作路径和下载器所在的目录在同一个盘下，如果不在同一个盘下，则执行下列命令先更新工作路径到下载器所在的盘（例如下载器在D盘的某个路径，那我就执行D:指令先切换到D盘）：
      在这里插入图片描述
    • 使用cd命令设置工作路径为下载器所在的目录：
      在这里插入图片描述
      在这里插入图片描述
    • 随后再执行前文提到的启动指令启动下载器即可。

补充五：离线方式安装老版本（5.14.2为例）

  1. 获取离线安装包
    • 官网下载链接：官网链接。官方的qt版本最全，进入后选择对应的版本目录即可下载对应离线安装包，但是国内可能无法访问，如果你没办法解决访问问题那就推荐通过我分享的网盘下载安装包。
    • 网盘分享链接：网盘链接。我这里分享了5.14.2和4.8.7的安装包，直接下载即可，如果需要其他版本或其他分享渠道也可私信我。
  2. 如下操作

    • 双击安装包运行，点击next。
      在这里插入图片描述

    • 输入自己的Qt账号（没有可以在官网注册一个，并不麻烦），点击next。
      在这里插入图片描述

    • 勾选协议，点击下一步。
      在这里插入图片描述

    • 点击下一步。
      在这里插入图片描述

    • 选择安装路径（不能包含中文、特殊符号、空格等），点击下一步。
      在这里插入图片描述

    • 勾选安装的组件后点击下一步。建议全部勾选，体积不大。
      在这里插入图片描述

    • 勾选同意协议后点击下一步。
      在这里插入图片描述

    • 点击下一步。
      在这里插入图片描述

    • 点击安装。
      在这里插入图片描述

    • 等待安装。由于是离线安装，所以安装时间和网速关系不大，主要取决于CPU计算能力，大概10-20分钟能够安装完成。
      在这里插入图片描述


http://www.kler.cn/a/404858.html

相关文章：

  • 为什么VScode不能连服务器,MobaXterm可以连
  • VMAuthdService服务启动不了~
  • VUE字符串转日期加天数
  • Vue 专属状态管理库Pinia的使用与实践
  • springboot高校毕业生实习及就业去向信息管理系统
  • NAT网络地址转换——Easy IP
  • C++20 协程入门
  • QT+osg+osgearth显示一个地球（进阶）
  • 《Java核心技术 卷I》链表
  • 多目标优化算法：多目标吸血水蛭优化算法（MOBSLO）求解DTLZ1-DTLZ9，提供完整MATLAB代码
  • 集合卡尔曼滤波（Ensemble Kalman Filter），用于二维滤波（模拟平面上的目标跟踪），MATLAB代码
  • 机器学习——数据隐私与安全学习
  • 排序算法：直接插入排序，希尔排序，选择排序，快速排序，堆排序，归并排序
  • 【IEEE独立出版 |往届均已成功检索】第八届大数据与应用统计国际学术研讨会（ISBDAS 2025）
  • C#核心（10）拓展方法
  • 机器学习：智能技术的未来
  • Vue_Router权限控制：不同角色显示不同路由
  • MySQL基础大全（看这一篇足够！！！）
  • 解决.DS_Store 在项目一致无法排除，.gitignore里也不生效
  • C++ 网络编程：打造多线程 TCP 服务器，同时服务多个客户机！
  • Qt-常用的按钮控件 QPushButton QRadioButton QCheckBox
  • Kadane 算法 二维 详解
  • 如何创建一个网站？初学者的分步指南
  • 【Apache Paimon】-- 5 -- Flink 向 Paimon 表写入数据
  • 网络编程day2.2~day3——TCP并发服务器
  • TCP Listen 队列详解与优化指南