目录
0.前言
Qt介绍
QT 是一个跨平台的应用程序开发框架,它提供了丰富的工具和类库,用于开发图形用户界面(GUI)程序。Qt 提供了 C++ 编程语言接口,同时也支持其他编程语言,如 Python和QML。
以下是 QT 的一些主要特点:
- 跨平台:Qt 支持在多个操作系统上进行开发,包括 Windows、macOS、Linux、Android 和 iOS 等。通过编写一次代码,可以在不同平台上进行部署和运行。
- 高度集成的开发环境:Qt 提供了 Qt Creator,一个集成的开发环境,用于代码编辑、调试和界面设计。它提供了丰富的工具和可视化设计器,使开发过程更加高效。注意:Qt是一个应用程序开发框架,Qt Creator则是其提供的一个IDE,注意区分
- 强大的图形用户界面库:Qt 的 GUI 框架提供了丰富的 UI 控件和布局管理器,使开发者可以轻松创建各种功能齐全的界面。同时,Qt 还支持自定义样式和主题,使界面能够与平台和用户需求相适应。
- 响应式编程:Qt 引入了信号与槽机制,用于在对象之间进行通信和事件处理。这种机制使得编写响应式的代码更加简单和直观。
- 数据库支持:Qt 提供了对多种数据库的支持,包括 MySQL、SQLite、PostgreSQL 等,使开发者能够方便地进行数据持久化和处理。
- 多媒体功能:Qt 提供了大量的多媒体功能接口,包括音频、视频、图像处理等,使开发者可以轻松地实现音视频播放、图像处理等功能。
其他
- 本博客的初心是帮助小白快速入门搭建好Qt环境,减少环境搭建的烦恼。
- 书写的过程中我在尽力的写得非常细致,减少大家的阅读困难。
- 如果有错误、需要改进的地方欢迎大家评论或私信,我会尽可能的回复并纠正。
- 如果环境搭建遇到困难或者报错,也欢迎评论或私信我(请详细描述问题或直接截图),我会尽可能帮助你。我的回复可能不及时,但一般都在几个小时内
- 如果对您有帮助还请点赞收藏支持一下博主,感谢感谢!
1.下载安装QT
-
进入官网
提醒:因为QT5.14.2之后的版本不再提供离线安装包,所以需要去官网下载在线安装器,我这儿也提供了下载好的网盘分享链接
官网地址为:QT官网
下载页面地址为:下载页面
在线下载器的网盘分享链接:在线下载器的网盘分享链接 -
点击Download.Try.
-
点击选择开源版
-
下拉,点击Download the Qt Online Installer
-
选择对应的版本并下载,我这儿下载Windows版本
-
下载完成后,找到下载器所在的文件夹,确保下载器在该文件夹之后,点击鼠标右键,点击“在终端中打开”,这样就可以打开终端并使其工作目录在这个文件下。如果无法通过该方法打开终端可以查看后文《补充四》
-
打开该终端之后执行一条启动命令。形如:
- 先别急着直接用,听我先解释清楚这个指令。
这个指令可以分为三个部分,上面我用绿色的线标注了
.\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%概率你没认真看我写的解释,指令的第一部分不正确。
-
输入Qt账号并登录,如果没有的话可以注册一个,并不麻烦
-
如图
-
如图
-
如图
-
选择合适的文件夹安装
整个路径一定不能包含中文字符、空格等
-
如图勾选,点击筛选,这样可以看到很多可以下载的版本
-
选择需要的版本进行下载,我的勾选如下
注意:一般只需从Qt栏中选择一个对应版本,其他默认即可
我这里选择了5.14.2下的所有库,但这样软件体积很大且对入门选手没什么用,大家可以参考《补充一》选择部分库进行安装
- 2024.08.27更:现在Qt已经不再提供5.14.2版本,最小的版本是5.15,大家可以也可以下载这个版本,各个小版本之间的差异不大。如果需要使用Qt6,那么我推荐下载6.5.3,这是一个长期支持版本,镜像库也比较完整,一般不会出错。如果下载其他版本,可能会因为镜像库内容不完整等原因导致后续下载过程中出现“无法下载存档”等提示信息对话框,这是有忽略按钮就点击忽略,没有则点击重试,重试无法解决就放弃下载这个版本,转而下载6.5版本或5.15版本。如果这两个版本也有这个错误,那么放弃Qt(开玩笑的,博主目前没遇到过,如果大家遇到了就搜搜其他的教程吧)
-
如图
-
如图
-
如图
-
等待安装完成
-
如图
2.创建并编写第一个Qt程序
- 点击创建项目
- 如图
- 输入项目名称、选择项目路径、点击下一步
注意:项目名称和项目路径不能包含中文符号、空格等
- 选择构建工具
qmake是Qt提供的构建工具,用于简化 Qt 项目的构建过程。
CMake 是一个跨平台的开源构建工具,用于管理和构建 C++ 程序的软件项目。与 qmake 类似,CMake 的目标是简化跨平台软件项目的构建过程。
Qbs,全称:Qt Build Suite,是由Qt官方提供的一个跨平台构建工具,用于构建和管理Qt和非Qt项目。它是Qt Creator集成开发环境(IDE)的一部分,但也可以独立使用。
我这儿选择qmake
- 选择基础类
我这儿选择QWidget - 如图
- 选择构建套件
我们使用QtCreator编写时,选择MinGW对应的版本,例如我这儿选择MinGW 64位
如果使用Microsoft Visual Studio编写Qt程序则选择MSVC的对应版本,这个后文有说明
- 如图
- 等待构建
此时Qt Creator会开始构建项目,右下角有进度条可以看见,如果全部是绿色则说明构建成功
- 运行项目
此时我们点击左下角运行按钮,可以看见弹出一个窗口,说明项目成功运行,我们的环境安装没有问题
3.配置Visual Studio编写Qt程序的环境
- 点击扩展->管理扩展
- 如图
在联机中搜索Qt,下载Qt Visual Studio Tools
- 等待下载完成后关闭Visual Studio 所有窗口。如果下载过程太慢可以尝试《补充三》的方法
- 此时会弹出一个窗口,点击Modify
- 下载完成后点击Close
- 再次打开Visual Studio,进入Qt Versions
- 此时插件会自动检测已经安装的Qt套件(比如他就检查到我已经安装了6.5.2版本),如果你还需要添加其他已经下载的版本,可以点击add new Qt version
- 点击这个文件夹图标
- 找到对应套件下的qmake.exe文件进行添加
途中标识了这个文件的相对路径,可对照自己的Qt安装位置查找
注意:在VS环境中就添加MSVC版本的套件,而不是MinGW套件
- 点击确定完成,下面我们新建一个项目试试能否成功运行
- 点击文件->新建->项目
- 如图
- 输入项目名称、位置、解决方案名称,点击创建
我主页有博客介绍了VS如何创建有层次结构的解决方案、项目,大家可以看看,此处不再赘述
- 此时弹出一个对话框,点击Next
- 如图
- 选择Debug,一般我们编写Qt程序时选择Debug进行创作,Release是发行版本
- 选择对应的套件版本,注意是msvc的
- 打勾
- 选择Qt模块,一般初学时选择Core、Gui、Widgets即可
- 点击Next
- 如图
- 进行一些项目信息的设置
- 这儿我选择的基础类为QWidget,默认的QMainWindow也可以
- 创建完成,点击运行
出现这个窗口即成功创建好环境
补充
补充一:仅选择必要部分安装
声明:对于存储空间充足的用户,仍然推荐下载完整的模块,避免后期造成不必要的麻烦
编译套件选择:推荐安装MSVC和MinGW的对应版本套件各一个,MSVC套件可以让你在Visual Studio下开发,MinGW可以让你在Qt Creator下开发,两个各选择一个版本以备使用,如下图所示。如果你是ARM架构芯片则选择ARM版本。
工具链选择:推荐选择一个最新版的MinGW工具链,如下图所示。
这一套选下来只要6GB,这样就大大减轻了硬盘压力。
补充二:后期添加未安装的模块
当在后期开发过程中发现部分功能模块在初始安装时没有安装,也可以借助Qt自带的维护工具快速补充安装,该工具还可以对一些已经安装的组件进行更新,操作方法如下:
- 进入Qt的安装目录,启动MaintenTool.exe工具
安装目录就是你开始安装Qt的根目录。
进入后可以找到这个MaintenTool.exe文件,双击启动它,如果在后续更新过程中发现网速太慢,同样可以用前文启动在线下载器时的方法启动MaintenTool.exe,如在终端依次执行如下命令:
# 使终端工作环境为Qt根目录(需要根据自己的安装目录修改该命令)
cd E:\ProgramFiles\Qt
# 使用镜像网站启动MaintenanceTool.exe
.\MaintenanceTool.exe --mirror https://mirrors.aliyun.com/qt/
- 按照如下步骤操作
如图:
如图:
勾选三个选项之后点击筛选,等待刷新完成。如图:
进入你需要安装的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即可
随后等待安装完成即可。
补充四:通过命令行窗口打开安装程序
- 打开命令行窗口
- 法一:直接在安装程序所在的目录空白区域右击鼠标,在右键菜单点击“在终端打开”
- 法二:在Windows的搜索中输入Powershell,然后点击打开
- 法三:右击Windows开始菜单,点击“终端”
- 法一:直接在安装程序所在的目录空白区域右击鼠标,在右键菜单点击“在终端打开”
- 设置终端当前工作路径
解释:终端运行时有一个工作路径(工作目录)的概念,其只能识别该路径(目录)下的文件,所以我们在执行命令启动程序之前需要先设置终端的当前工作路径为安装程序所在的目录。- 终端打开默认的工作路径一般是C盘的某个路径,先确认默认的工作路径和下载器所在的目录在同一个盘下,如果不在同一个盘下,则执行下列命令先更新工作路径到下载器所在的盘(例如下载器在D盘的某个路径,那我就执行D:指令先切换到D盘):
- 使用cd命令设置工作路径为下载器所在的目录:
- 随后再执行前文提到的启动指令启动下载器即可。
- 终端打开默认的工作路径一般是C盘的某个路径,先确认默认的工作路径和下载器所在的目录在同一个盘下,如果不在同一个盘下,则执行下列命令先更新工作路径到下载器所在的盘(例如下载器在D盘的某个路径,那我就执行D:指令先切换到D盘):