01-1-QT安装

一、QT下载、安装、入门、配置

文章主要参考CSDN_清豆°的文章《【保姆级图文教程】最新Windows系统QT下载、安装、入门、配置VS Qt环境,图文详细、内容充实》^[https://blog.csdn.net/qq_62888264/article/details/132645054]

1-下载安装QT

Qt的安装方式有两种:

  1. 在线
     在线安装稍麻烦,能安装5.15及之后的版本,便于安装多个版本在根目录下进行后期管理
    
  2. 离线
     离线安装更简单,能安装5.14及之前的版本,安装速度不依赖于网速,但不便于多个版本的统一管理
    

进入官网Qt | 软件开发全周期的各阶段工具或直接进入下载页Download Qt OSS: Get Qt Online Installer

选择对应版本下载

打开安装包所在的文件夹

点击鼠标右键,点击在终端中打开

输入

1
.\name --mirror https://mirrors.ustc.edu.cn/qtproject/  

name为刚刚下载的安装包的名称,如此处为

1
.\qt-online-installer-windows-x64-4.9.0_2.exe --mirror https://mirrors.ustc.edu.cn/qtproject/  

进入安装界面

登录QT账号

勾选后下一步

选择合法的安装文件夹,点击自定义安装,勾选后点击下一步
合法的路径:整个路径一定不能包含中文字符、空格、特殊字符等

显示所有版本

下一步

关联文件

安装完毕

完成

2-在Qt Creator创建并编写第一个Qt程序

点击创建项目

选择项目模板后点击选择,一般选择Application(Qt)下的Qt Widgets Application即可:

输入项目名称、选择项目路径、点击下一步
注意:项目名称和项目路径不能包含中文符号、空格、特殊字符等

选择构建工具:
qmake是Qt提供的构建工具,用于简化 Qt 项目的构建过程。
CMake是一个跨平台的开源构建工具,用于管理和构建 C++ 程序的软件项目。
Qbs,全称:Qt Build Suite,是由Qt官方提供的一个跨平台构建工具,用于构建和管理Qt和非Qt项目。它是Qt Creator集成开发环境(IDE)的一部分,但也可以独立使用。
一般选择默认的qmake即可,你会cmake选择cmake也可以。

选择基础类和主类的名字:

基础类提供了QMainWindow、QWidget、QDialog,选择默认的QMainWindow即可,QWidget要轻量简单一点,也可以,QDialog用的少。主类Class Name可以自定义,不过要符合C++的语言规范

点击下一步

选择构建套件

我们这里是使用QtCreator编写时,必须选择MinGW编译套件
如果使用Microsoft Visual Studio编写Qt程序则必须选择MSVC编译套件,这个后文有说明

点击完成

等待项目构建
1、此时Qt Creator会开始构建项目,右下角有进度条可以看见,如果全部是绿色则说明构建成功
2、好像也可能出现一两个红杠,不管他,以下一步能否正确运行出现小窗口为准

运行项目
此时我们点击左下角运行按钮,可以看见弹出一个窗口,说明项目成功运行,我们的环境安装没有问题。

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

打开VS,在上方菜单栏找到并点击扩展->管理扩展

如图,在浏览中搜索Qt,点击安装开始下载Qt Visual Studio Tools插件

再次打开Visual Studio,进入Qt Versions

点击Add开始添加Qt版本

选中条目之后点击...去找到qmake.exe文件的位置
注意:在VS环境中只能添加MSVC版本的套件,不能MinGW套件(添加了也无法使用)

随后使用同样的方法添加你下载的所有(MSVC)版本即可,添加完之后点击确定完成插件的设置

接下来开始新建VS Qt项目运行:
点击文件->新建->项目

在搜索框输入Qt可以查看插件为我们提供的所有VS Qt项目模板,一般我们选择Qt Widgets Application模板即可,选择后点击下一步

输入项目的名称位置解决方案名称等信息后点击创建
上述信息一定不要包含中文、空格、特殊字符等,否则后续会报错

点击Next

  1. 选择构建系统,默认的方便适用,选择默认的即可;
  2. 选择Debug版本和Release版本的各自使用的Qt版本(一般我们编写程序时运行Debug版本,Release则是发行的版本),建议两个要选择一致;
  3. 然后选择对应用到的Qt模块(默认已经选择上Core、Gui、Widgets三个模块,这是三个基础模块,对付一般的简单应用已经足够,后续需要用到其他模块时还可以再添加);
  4. 不建议勾选Enable PCH Support;
  5. 随后点击Next

  1. 选择主要类的类名,符合C++规范即可;
  2. 选择基础类,这是主要类会继承的类,有三个可以选择,一般选择默认的QMainWindow即可,QWidget更轻量,QDialog用的少;
  3. 填写其他文件的名字,建议和主类的名字保持一致;
  4. 勾选是否使用小写文件名(大小写无所谓)、是否添加默认的应用图标(勾选上运行出来的程序会带上Qt的默认图标,否则是一个终端的图标不那么美观),根据自己的喜好选择,我比较懒,就默认不勾选了;
  5. 填写选择完毕之后点击Finish完成项目创建:

随后运行项目,出现小窗口即说明VS中的Qt开发环境配置成功

二、资源下载

主要参考CSDNersaijun的文章《全网最全的Qt下载途径(多种下载通道+所有版本)》^[https://blog.csdn.net/kaspar1992/article/details/107588850]

QT可以从官网下载,也可以使用国内的镜像网站进行下载

1-官网下载

Qt 官网有一个专门的资源下载网站,所有的开发环境和相关工具都可以从这里下载,具体地址是:https://download.qt.io/

官网界面如下

对目录结构的说明

目录 介绍
snapshots 预览版,最新的开发测试中的 Qt 库和开发工具
online Qt 在线安装源
official_releases 正式发布版,是与开发版相对的稳定版 Qt 库和开发工具(可以下载Qt开发环境和源代码)
new_archive
ministro 迷你版,目前是针对 Android 的版本
linguist_releases
learning 有学习 Qt 的文档教程和示范视频
development_releases 开发版,有新的和旧的不稳定版本,在 Qt 开发过程中的非正式版本
community_releases 社区定制的 Qt 库,Tizen 版 Qt 以及 Qt 附加源码包
archive 各种 Qt 开发工具安装包,新旧都有(可以下载 Qt 开发环境和源代码)

archive 和 official_releases 两个目录都有最新的 Qt 开发环境安装包,我们以official_releases目录里的内容为例来说明。

进入 qt 子目录

有各种子版本

2-镜像源下载

这里给大家推荐几个国内著名的 Qt 镜像网站,主要是各个高校的:

中国科学技术大学:http://mirrors.ustc.edu.cn/qtproject/
清华大学:https://mirrors.tuna.tsinghua.edu.cn/qt/
北京理工大学:http://mirror.bit.edu.cn/qtproject/
中国互联网络信息中心:https://mirrors.cnnic.cn/qt/


QT


01-1-QT安装
https://pattianfang.github.io/2025/04/12/01-1-QT安装/
作者
Pat Tian Fang
发布于
2025年4月12日
更新于
2025年5月3日
许可协议