【保姆级图文教程】最新Windows系统QT下载、安装、入门、配置VS Qt环境，图文详细、内容充实

【保姆级图文教程】最新Windows系统QT下载、安装、入门、配置VS Qt环境，图文详细、内容充实

前言 1.下载安装QT（2025.01.10更新图文）

说明：

1. Qt的安装方式有两种：1、在线（推荐）；2、离线。在线安装稍麻烦，能安装5.15及之后的版本，便于安装多个版本在根目录下进行后期管理；离线安装更简单，能安装5.14及之前的版本，安装速度不依赖于网速，但不便于多个版本的统一管理。

2. 本文两种方法均提供，本节的方法为在线安装方法，离线安装可以参看《补充五》

进入官网

去官网的目的是下载在线安装器，我这儿也提供了在线安装器的网盘分享链接，如果通过网盘链接下载了安装器就可跳转到后续打开在线安装器的步骤

点击.Try.

点击选择开源版

下拉，点击 the Qt

选择对应的版本并下载，我这儿下载版本

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

打开该终端之后执行一条启动命令。形如（注意，心急吃不了热豆腐，我说的是形如，因为你的下载器版本不一定和我一样，所以你需要看我这里的解释，看完你自然就知道你的命令是怎样的了，）：

这个指令可以分为三个部分，上面我用绿色的线标注了
# 第一部分：这一部分表示我要启动一个程序，就是指定了启动的程序的路径，因为我已经让你的终端工作环境为下载器所在的目录，所以这儿使用的是相对路径（当然你也可以使用绝对路径，直接右键文件复制完整路径进行替换即可，这是很基本的知识，不会请自行上网）。
.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账号并登录，如果没有的话可以注册一个，并不麻烦。（注册流程可以参看《补充六》，如果你在登录时显示“不是开源账号”等字样，则可以按照我的流程操作，我验证了这个方法注册的账号是可以登录使用的。）

如图，勾选两个选项之后点击下一步

如图，点击下一步

如图勾选，点击下一步

选择合法的安装文件夹，点击自定义安装，勾选后点击下一步

合法的路径：整个路径一定不能包含中文字符、空格、特殊字符等

如图勾选，点击筛选，这样可以看到很多可以下载的版本。（上面出现一行红色字体不用管）

选择需要的Qt版本，我的选择如下，供参考

这里我选择下载Qt 6.5.3的完整版本，直接勾上即可。完整安装一个版本的好处是省心，所有组件（模块）都安装了，但是占用体积比较大。如果你的硬盘空间有限，可以参考后文《补充一》，我会提供Qt 6.5.3和Qt 5.14.2版本的部分库安装选择推荐

选择完毕之后点击下一步

勾选同意协议，点击下一步

点击下一步

点击安装

等待安装完成

安装完成之后点击下一步

根据自身情况选择是否立即启动，然后点击完成

至此，Qt的安装完成，可以通过的搜索功能启动Qt 进行后续步骤。

2.在Qt 创建并编写第一个Qt程序（2025.01.10更新图文）

通过的搜索功能启动Qt ，找不到搜索图标可以按键盘上的键（一般在键盘的左下角）。

点击创建项目

选择项目模板后点击选择，一般选择（Qt）下的Qt 即可：

输入项目名称、选择项目路径、点击下一步

注意：项目名称和项目路径不能包含中文符号、空格、特殊字符等

选择构建工具：

qmake是Qt提供的构建工具，用于简化 Qt 项目的构建过程。

CMake是一个跨平台的开源构建工具，用于管理和构建 C++ 程序的软件项目。

Qbs，全称：Qt Build Suite，是由Qt官方提供的一个跨平台构建工具，用于构建和管理Qt和非Qt项目。它是Qt 集成开发环境（IDE）的一部分，但也可以独立使用。

一般选择默认的qmake即可，你会cmake选择cmake也可以。

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

点击下一步

选择构建套件

点击完成

等待项目构建

1、此时Qt 会开始构建项目，右下角有进度条可以看见，如果全部是绿色则说明构建成功

2、好像也可能出现一两个红杠，不管他，以下一步能否正确运行出现小窗口为准

运行项目

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

接下来，如果你愿意浪费5s时间，建议看一下补充八，因为博主手已经伸出来半截了。

3.配置 编写Qt程序的环境（2025.01.19更新图文）

注意：

1、在进行这一步之前你首先要知道 （本节后续称VS）是什么，如果当你看到此处时不知道这个问题的答案，那么你在看完本段注意事项之后就不用再看这一节了。

2、VS是微软公司旗下的一款功能十分强大的IDE，是市面上主流的C++语言IDE。我这一节的目的是给习惯使用VS进行C++项目开发的同学提供通过VS进行Qt、C++项目开发的环境配置教程，所以如果你现在不知道VS是什么那么你就使用Qt自带的Qt 进行项目开发，本节不再需要观看（当然你有兴趣也可以看下去）。

3、下文环境配置默认你已经安装好了VS，如果没安装可以查看我的另一篇关于VS的博客：【 新手入门指导】。

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

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

等待下载完成后关闭 所有窗口。如果下载过程太慢可以尝试《补充三》的方法

此时会弹出一个窗口，点击开始安装插件

安装完成后点击Close

再次打开 ，进入Qt

点击Add开始添加Qt版本

点击后会弹出来一个新的条目：

选中条目之后点击…去找到qmake.exe文件的位置：

注意：在VS环境中只能添加MSVC版本的套件，不能MinGW套件（添加了也无法使用）

下图标识了5.15.2版本的qmake文件在Qt安装目录中的相对位置，不同版本的qmake文件的相对位置规律是一样的，可以参考这个来确定，这个规律你应该能看出来：

选择qmake文件确认后插件会自动补齐该版本的相关信息：

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

接下来开始新建VS Qt项目运行：

点击文件->新建->项目

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

输入项目的名称、位置、解决方案名称等信息后点击创建：

1、上述信息一定不要包含中文、空格、特殊字符等，否则后续会报错；

2、我主页有博客（【 新手入门指导】）介绍了VS如何创建有层次结构的解决方案、项目，大家可以看看，此处不再赘述；

点击Next：

1、选择构建系统，默认的方便适用【保姆级图文教程】最新Windows系统QT下载、安装、入门、配置VS Qt环境，图文详细、内容充实，选择默认的即可，插件还提供了CMake的构建方式，你会的话也可以选择，我反正不会；

2、选择Debug版本和版本的各自使用的Qt版本（一般我们编写程序时运行Debug版本，则是发行的版本），建议两个要选择一致（例如都选择5.15.）；

3、然后选择对应用到的Qt模块（默认已经选择上Core、Gui、三个模块，这是三个基础模块，对付一般的简单应用已经足够，后续需要用到其他模块时还可以再添加，参考《补充七》）；

4、不建议勾选 PCH （会多一个头文件、源文件，配置有点不同，曾经给我带来过麻烦，所以我对他不怎么有好感）；

5、随后点击Next：

1、选择主要类的类名，符合C++规范即可；

2、选择基础类，这是主要类会继承的类，有三个可以选择，一般选择默认的即可，更轻量qt安装教程 linux，用的少；

3、填写其他文件的名字，建议和主类的名字保持一致；

4、勾选是否使用小写文件名（大小写无所谓）、是否添加默认的应用图标（勾选上运行出来的程序会带上Qt的默认图标，否则是一个终端的图标不那么美观），根据自己的喜好选择，我比较懒，就默认不勾选了；

5、填写选择完毕之后点击完成项目创建：

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

至此，VS开发Qt项目的基础配置已完成，如果你希望使用Qt 编辑Qt应用程序的可视化界面，我推荐你再看看《补充十》，方便你双击.ui文件快速进行编辑。

至此，本文正文结束。如果你愿意浪费5s时间qt安装教程 linuxqt安装教程 linux，建议看一下补充八。（如果你已经看了当我放*）

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

1、声明：对于存储空间充足的用户，仍然推荐下载完整的模块，避免后期造成不必要的麻烦

2、编译套件选择：推荐安装MSVC和MinGW的对应版本套件各一个，MSVC套件可以让你在 下开发，MinGW可以让你在Qt 下开发【保姆级图文教程】最新Windows系统QT下载、安装、入门、配置VS Qt环境，图文详细、内容充实，两个各选择一个版本以备使用。（这一条很重要，后续使用Qt 开发一定要选MinGW套件，使用VS开发一定要选MSVC套件）

3、确认你的芯片的架构是amd还是arm

Qt 5.15.2（7GB左右）：

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

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

进入Qt的安装目录，启动.exe工具

安装目录就是你开始安装Qt的根目录。

进入后可以找到这个.exe文件，双击启动它，如果在后续更新过程中发现网速太慢，同样可以用前文启动在线下载器时的方法启动.exe，如在终端依次执行如下命令：

# 使终端工作环境为Qt根目录（需要根据自己的安装目录修改该命令）
cd E:ProgramFilesQt
# 使用镜像网站启动MaintenanceTool.exe
.MaintenanceTool.exe --mirror https://mirrors.aliyun.com/qt/

按照如下步骤操作

输入Qt账号密码后点击下一步：

选择添加或移除组件后点击下一步：

勾选三个选项之后点击筛选，等待刷新完成。如图：

进入你需要安装的Qt的版本目录，例如我这儿需要更新的是Qt6.5.3的组件，找到需要更新的组件，根据自己的需求选择相应的组件，选择完毕之后点击下一步。如图：

说明1：一般你缺少的一些模块在 里面就可以找到，需要什么就把他勾上。图中黄色方框框出了三个常用的模块，例如需要进行多媒体应用开发时（播放mp3音乐）就需要Qt 模块。

说明2：在你进入该目录时，你可能发现一些已有的组件已经被打上勾，如果你不是要卸载他们就不要取消打勾（因为这里打勾的含义是更新时候是否具有这些组件，而不是是否添加这些组件），因为取消后该维护工具会卸载他们。

点击更新：

等待更新完成。如图：

更新完成后点击下一步。如图：

点击完成或重新启动，至此完成更新。如图：

补充三： 插件安装

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

补充四：通过命令行窗口打开安装程序 打开命令行窗口 设置终端当前工作路径

解释：终端运行时有一个工作路径（工作目录）的概念，其只能识别该路径（目录）下的文件，所以我们在执行命令启动程序之前需要先设置终端的当前工作路径为安装程序所在的目录。 补充五：离线方式安装老版本（5.14.2为例） 获取离线安装包 如下操作 补充六：注册Qt账号 进入qt官网点击图示图标进入登录界面

点击 Qt

填写邮箱、密码、勾选同意协议，点击 Qt