前言

做软件开发，特别是用户图形界面交互方向，QT的应用越来越广泛了，因其可移植性，以及强大的配置库，大有替代VS的MFC的趋势，笔者2011年上大学的时候，一般开发GUI界面工程都还是基于MFC的框架，到了2015年开始研究生学习的时候，考虑到移植到嵌入式平台的应用需求，已经开始应用QT作为自己的毕设GUI界面开发平台了。正好现在自己的工作也主要与QT打交道，所以又重新捡回QT，后续会介绍多种QT开发的小技巧以及应用。

目前市场上对上位机，特别是QT开发还是比较受欢迎的，以笔者所在二线城市长沙为例，在求职市场上的岗位需求如下图可以看出，比较熟练应用QT的话，基本上薪资过万问题不大。

本系列第一章，介绍一下如何在VS2015中配置QT开发环境，话不多说，开始！

一. QT环境搭建

1.1 QT安装

官网下载一个QT：QT官网

我选择的是5.9.6（虽然文件名均显示为x86，其实安装的时候32位，64位都是可选的），找到Windows下的版本，点击下载

下载完成后，双击安装

点击“Next”，邮箱注册一个QT账号，输入账号密码点击“Next”

点击“下一步”开始安装，选择安装文件夹


点击“下一步”，根据需要选择需要安装的组件（选的越多安装所需空间越大，根据自己需求来选择，可以不用选我这么多）

点击“下一步”


选择接受协议，点击“下一步”

点击“下一步”

点击“安装”，开始安装


等待一段时间，安装完成

点击“完成”，Qt Create可以正常打开，即安装完毕

将QT添加到环境变量，计算机右键点击“属性”

点击“高级系统设置”

点击“环境变量”

找到系统变量中的Path，双击，添加QT路径

确定保存，重启电脑（环境变量生效）。

1.2 VS中安装工具库

打开VS2015

点击“工具”，选择“扩展和更新”

点击“联机”，右上角搜索框输入：QT(回车)

QT工具出现在第一行，点击“下载”

下载完毕，开始安装，点击“安装”

安装完之后，会显示一个绿色小勾，

建议把QtPackage也安装上（），点击“下载”


下载完毕，点击“安装”

安装成功

重启VS2015，工具栏出现“Qt5”、“Qt VS Tools”,报了一个弹窗错误：未能正确加载“Vsix”包

查到是装了Qt add插件后Qt插件自动更新了 ，导致版本不匹配（没有警告，就忽略这里），扩展和更新中Qt插件有个自动更新选项，取消自动更新。


重启VS2015，不弹出报错，点击工具栏“Qt5”，选择“Qt Options”

点击“Add”，配置QT路径

选择QT路径

点击"OK"

再点击“OK”，保存默认QT版本，QT环境搭建完成！下面进行创建一个小小的QT应用实例，简单介绍一下。

二. QT简单工程示例

打开VS2015，新建一个项目，列表项选择“Qt5 Projects”，选择“Qt Application” ,选d定项目位置，输入项目名

点击"确定"

点击“下一步”，配置所需QT库

本文仅介绍简单GUI工程示例，所以默认配置项，点击“Finish”，进入工程界面

基本的QT GUI文件均已配置完成，打开“project1.ui”（默认为安装好的Qt Creator 打开）

在这里可以对GUI进行设计，默认只有窗口，无任何控件，回到VS2015，点击工具栏中“生成”中的“生成解决方案”

生成成功，点击“调试”中的“开始调试”（或者绿色小三角）

弹出GUI界面，调试成功。本实例仅作为确定QT可以进行开发了的验证，所以没有添加任何控件或者其他功能，目的是搭建好QT环境，测试验证一下。

三. 小结

本文主要介绍了在VS2015中配置QT5.9.6的过程，主要是为后续进行基于QT的GUI工程开发做好准备工作，后续会在GUI中添加相关控件，以及各种不同功能进行设计开发，争取实现几个落地项目进行详细介绍，欢迎各位同学一起学习交流。

一:安装VS2017

微软官网下载地址：
https://visualstudio.microsoft.com/zh-hans/vs/older-downloads/
（备用）蓝奏云下载地址：https://wwa.lanzoui.com/ifroLq5dhqh		密码:2017

二:安装Qt5.12.9

Qt
Download

国内镜像网站
这里给大家推荐几个国内著名的 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资料介绍和下载：http://c.biancheng.net/view/3851.html

注意：安装Qt时一定要选择msvc2017 32和64，其他可选可不选，看个人。

三.在VS2017中配置

这一步才是我们的最终目的，VS2017中可以直接下载QT插件，所以配置过程也比较简单。首先我们打开Visual Studio 2017主界面。

在上方菜单栏选择工具-》扩展和更新。

左侧菜单栏点击联机，在右上输入框中输入Qt进行搜索，搜索结果第一个就是Qt VS Tools，直接点击下载即可。下载速度可能比较慢，被墙的关系，好在不大。

下载完成后会提示需要关闭VS2017，关闭后会跳出安装界面，直接点击修改即可。

如果安装不了 Qt Visual Studio Tools

（备用）蓝奏云下载地址：https://wwa.lanzoui.com/iYxiEq5dhwd  	密码:2017

安装完后重启VS即可看到菜单栏中多了QT VS Tools选项，可以看到这个工具还是比较强大的，可以直接在VS中打开QT的pro工程。首先我们点击Qt Options进行Qt安装路径设置。
因为同时安装了32位和64位的组件，所以可以将他们一起添加进来。在这里插入图片描述添加进来。
下方下拉菜单可以选择使用的工具版本，如果选择msvc2017则创建的QT工程是32位的，选择msvc2017_64则创建64位工程。在VS中创建QT工程的方法见下一步。

四.在VS2017中创建QT工程

在VS2017中依次点击文件-》新建-》工程，打开新建项目页面。

这里可以设置类名和文件名等，默认和项目名字一样。不需要修改的话直接点击Finish。

点击F5进入调试即可看到VS中出现了空的初始界面，到这里VS2017中的QT开发环境配置就全部完成了。

-------以上为基本配置，后面个人遇到的问题的解决办法-------

五.vs创建的qt项目无法定位程序输入点解决办法（仅供参考）

提示无法定位动态链接库，那我们就吧这些库加到项目目录下好了
解决办法呢是从你的开始菜单了，打开这样一个程序（根据你使用的编译器来哈，我用的是msvc2017的32位）

然后在这个程序中用cd转到你的项目目录，就是你的realse或者debuge目录下

最后用windeployqt 应用名称.exe这个命令就可以在你所在的目录下自动生成所需的dll文件啦
程序成功运行~
在前期我还修改了一下我的环境变量配置，对我的debug项目成功了。
就是把类似于D:\Qt\Qt5.12.9\5.12.9\msvc2017\bin这样的目录加到你的系统变量的path路径下，各位也可以试试哈

六.VS中双击ui文件无法打开的问题（仅供参考）

ui文件无法打开，或者是打开后报错的，突然间就来了这个问题，搞得我触不及防，不顾还好，最总还是被我解决了，下面将解决办法下来了，供大家参考

一、双击ui文件无法打开

解决办法：
１．右键ui文件，选择打开方式

２．再出现的窗体中点击添加

３．此时会出现一个小窗体，点击三个小点点进行添加designer.exe
４．找到自己的Ｑｔ安装路径中ｂｉｎ目录下
例如我的是：D:\Qt\Qt5.12.9\5.12.9\msvc2017\bin
找到designer.exe，然后点击打开

５．适当修改一下名字
发现路径已经添加进来的，可以适当的修改一下名字

七.VS“无法查找或打开PDB文件” 解决方案（仅供参考）

使用 VS（Visual Studio）编译程序时会出现“无法查找或打开PDB文件”的提示，并且此时程序会生成失败，无法运行，如下图所示：
大家不要惊慌，出现这种提示并不是代码写错了，而是编译器设置的问题，改一下设置就 OK 了。

先说一下PDB文件是什么

当程序在 VS 上编译时，程序所依赖的所有动态链接库（dll 文件）也会被编译，编译过程中每个 dll
都会产生一个pdb文件，又称为“符号文件”，是一个存储数据的信息文件，其包含 dll
库在编译过程的某些调试信息，例如程序中所用到的全局变量、局部变量、函数名以及他们的入口地址等。

pdb
文件主要用于调试程序，多用于当VS中有多个项目，且项目之间互有依赖关系时，使用pdb文件调试程序，往往会事半功倍，初学者一般不会用到。

当使用VS
调试程序时，会默认加载你的程序以及程序依赖的dll库产生的所有pdb文件，但是结果往往是VS自己找不到依赖库的pdb文件，于是就提示给你“无法查找或打开pdb文件”。
如何修复这个错误

我们可以通过对 VS 做适当的设置，使之能够查找到相应的 PDB 文件，具体步骤如下（这里我们以 VS2017 为例进行说明，其它版本的
VS 操作步骤也一样）。

1. 选择菜单栏中的“调试 --> 选项”，如下图所示：
   

2. 弹出“选项”对话框后，选择“调试 --> 常规”，在右侧选项栏中勾选“启用源服务器支持”（包含的 3 个子选项不用勾选），此时会弹出一个安全警报框，选择“是”即可，如下图所示：
   3) 还是在“选项”对话框中，选择“调试 --> 符号”，在右侧选项栏中勾选“Microsoft符号服务器”，此时会弹出一个提示对话框，点击“确定”即可。同时，对于缓存符号的目录，选择图示中的目录即可：
   

3. 确定之后，重新运行你的程序，首次运行时，由于编译器会加载所有动态链接库的pdb文件，可能会等到几秒钟。程序运行后，之前输出窗口中的“无法查找或打开pdb文件”的提示不见了，如下图所示：

如上图所示，由于pdb文件，又名“符号文件”，所以“已加载符号”，也就是成功加载了动态链接库对应的pdb文件。

八.VS下载源码和匹配的pdb文件的方法（仅供参考）

这里以5.12.9版本进行演示

1：首先在qt的安装目录下找到MaintenanceTool.exe，运行它
2.依次 点击设置-资料库-临时资料档案库-添加按钮

3.依次添加3条记录

https://download.qt.io/online/qtsdkrepository/windows_x86/desktop/qt5_5129/
https://download.qt.io/online/qtsdkrepository/windows_x86/desktop/tools_mingw/
https://download.qt.io/online/qtsdkrepository/windows_x86/desktop/qt5_5129_src_doc_examples/

5129代表的是5.12.9，也可以替换成其它版本，添加完效果如下

4.点击OK按钮，返回到主界面一路点next，选择添加或移除组件
5:继续下一步，然后在配置界面中选中Qt Debug Information Files 和Sources进行下载安装即可
6.qt配置完成后，打开vs2017在解决方案右击属性
7.启动项目-》当前选定内容

8.调试源文件-》添加下载好的源文件

八.Qt MSVC 2017 32bit 编译出现“error: C2131: 表达式的计算结果不是常数”错误（仅供参考）

1.在MinGW 32bit下正常编译的

	qint64 fileLen = dstFile.size();
 char fileBuffer[fileLen];

2.切换成MSVC 2017 32bit 编译后提示：

	D:\readfile.cpp:305: error: C2131: 表达式的计算结果不是常数

3.原因是定义数组时尺寸是不能用变量的。

	int b[] = { 1,2,3,4 }; 或者 int b[4] = { 1,2,3,4 }; 都行

4.下面这样写就可以：

     qint64 fileLen = dstFile.size();
     char *fileBuffer = new char[fileLen];

九.用VS打开qt写好的代码 (MinGW 与 MSVC 版本切换)（仅供参考）

具体细节请参考：MinGW 与 MSVC 版本切换

十.VS2017修改编码格式为utf-8，再也不用担心乱码了（仅供参考）

具体细节请参考：VS2017修改编码格式为utf-8

十一.用Qt查看和调试 Qt 源码（仅供参考）

1：下载微软的CDB调试器，链接
2：CDB调试器安装教程

CDB调试器安装完成。
3：安装Qt的时候，下图中这两个一定要勾选。4：

5，还有最后一步，需要pdb文件（这里我用的是msvc）。下载地址：链接

6：运行程序，查看源码。完成。

十二.用VS查看和调试 Qt 源码（仅供参考）

1：2：
:3：
4：设置好断点，点击运行F11进入，就可以查看源码。
5：完成，Qt和VS查看源码的过程。

#####最后一次更新时间：2021.12.24

#####学习过程中继续更新。。。。。

其他链接

VS插件下载地址（需要手动安装）
vs2015如何安装vsix扩展工具

目录

更新说明

学习Qt、安装Qt环境的困扰

     问题1：该选什么操作系统，该用MinGW还是msvc ?

     问题2：如果用visual studio该安装哪个qt版本？

     问题3：Qt开发商业软件需要付费授权吗？

Visual studio Qt 安装步骤

一、安装VS2019

二、安装Qt5.14 

三、安装vsaddin         

四、设置Qt路径创建Qt项目  

五、vs2019 Qt常见病症

六、我的Qt专栏

七、Qt高级开发视频教程

---

更新说明

--------------------------------------------

2022-01-24

        vs2022 qt vsaddin已经更新，可以使用了，链接：Index of /archive/vsaddin/2.8.1

目前是2.8.1，当你看到这篇博客时，可以往vsaddin那级目录看看，是不是更新了vsaddin。

        本文介绍的是vs2019与qt5.14的安装，在写本文时还没有vs2019对应的qt,  但是并不妨碍vs2019使用qt5.14对应的vs2017 qt;

        大家可以选择vs2022 + qt5.15.2/或qt6的搭配安装，或者vs2019 + qt5.15.2

--------------------------------------------

学习Qt、安装Qt环境的困扰

         很多人在学习Qt时，纠结于Qt开发环境的安装，是用linux还是windows, 该安装Qt哪个版本，还有来自博客文章的观点，比如不要使用windows, 用windows没出息，直接用linux，vs2019垃圾之类的，那么就市场占有率来看，windows在日常办公依然是绝大部分，linux在后台服务器有一定的分量，开发请不要有系统歧视的心态，甚至有人除了macOS，鄙视一切windows笔记本，这种真的好吗，中国还有很多家庭，单位用不起mac笔记本。

        在安装Qt开发环境之前，先声明三个问题。

     问题1：该选什么操作系统，该用MinGW还是msvc ?

        操作系统可以根据各人的工作情况选，我主要说说msvc与MinGW，Qt是很优秀的图形界面跨平台开发框架，开发语言可以用C++, 也可以用python,  建议使用C++。Qt只是一个C++开发框架，它需要C++编译器环境的支持，在windows上可以用msvc, 也就是visual studio的C++编译环境，也可以用MinGW, 类linux的C++环境，在linux则是g++/gcc, macOS则是clang, 所以在windows上安装Qt时有人疑惑为什么还要安装visual studio. 直接使用QtCreator不行吗，这个是可以的，在安装时选择MinGW版本的Qt即可，在下面的安装步骤将会看到。用visual studio, 主要是vs的调试、开发比较方便，QtCreator真是太难用了。

     问题2：如果用visual studio该安装哪个qt版本？

       一般来说，大概是这么个搭配

       vs2015匹配的大概是 Qt5.7 、5.9、5.6这些

       vs2017匹配的大概是 Qt5.9~~~Qt5.14

       vs2019/vs2022匹配的大概是 Qt5.14~~~Qt6

     问题3：Qt开发商业软件需要付费授权吗？

       需要授权，如果你们是上市公司，使用Qt开发应用，需要购买Qt的企业版，我们公司收到过Qt的律师函，关于费用，大家可以去看看，如果小型未上市的企业，应该问题不大，但是如果你们的应用用户很多，例如腾讯会议、剪映PC端这种软件，那还是需要Qt授权的，腾讯会议使用的商业版Qt。

        个人学习，使用Qt，没有版权问题。

Visual studio Qt 安装步骤

        下面正式介绍VS2019 + Qt5.14开发环境的配置, 其它版本类似，安装步骤如下：

一、安装VS2019

          VS下载链接：Visual Studio 2022 IDE - 面向软件开发人员的编程工具

          VS2019 C++主要安装模块：

          不用C#, python的，可以只勾选C++模块：

          扩展，Qt插件会展现在这里面   

 

二、安装Qt5.14 

       Qt5.15以后需要在线安装，本篇博客不做介绍，关于Qt5.15, Qt6的安装可以看这篇博客：【Qt5.15安装】 。

       如果你能翻墙，或者网速还可以，可以用这个链接下载Qt：Index of /archive/qt ，如果进不了这个链接，就用下面的清华镜像。 

       点击下面红框的Qt选择相应的版本，Qt5.7之前的版本不建议使用，很多功能都没有，现在最新的是5.15，可以选择5.14，低于该版本的可能没有VS2019对应的Qt.

          Qt5.14.2 如下图：

             清华镜像 清华大学开源软件镜像站 | Tsinghua Open Source Mirror  这里有所有软件的下载链接

             找到Qt

         VS2019安装好后，就可以安装Qt了，注意：安装Qt前最好断网(5.14之前的版本断网安装可以，5.15之后必须在线安装了)，不然无法next，需要账号注册，很麻烦。

        勾选自己需要的版本，建议32,64位的都勾上，没有VS2019,  但是vsaddin插件依然可以找到VS2017的Qt, 安装步骤主要截图如下：

三、安装vsaddin         

        Qt安装结束后，再安装Qt VS插件，还是前面的链接，找到vsaddin

           选择VS2019的版本, 我选的是2.5版本

            安装VS Qt插件前，关闭VS,Qt, 插件会自动识别VS的版本，如下图

        注意：在安装vsaddin插件时，某些情况下可能会失败，比如windows sdk版本太低，win10系统安装有问题，win10系统太久没更新，都有可能导致vsaddin安装失败。       

四、设置Qt路径创建Qt项目  

        以上都安装好后，打开VS，由于VS2019相对于之前的版本启动界面做了一些改动，先任意新建一个C++项目，设置Qt路径，不设置Qt路径的界面可能会这样

     Qt路径设置如下图：

2021-11-17 更新---------------------------------------------------------------------------

新版的qt vsaddin插件，不再是用Qt Options设置Qt路径，而是Qt Version，如下图：

点击之后

 注意qt路径，不要包含到bin这一层

 另外，vs2022也可以使用qt插件了，11月15更新的

 下面的图例是比较早的qt vsaddin插件配置图，2.6之后估计就不适用了。

------------------------------------------------qt vsaddin 2.6-----------------------------------------------------------

        

         

                找到Qt安装路径，选择msvc2017目录，这是32位的，添加ok后，也可以把64位的添加上

          再次点击Add就可以添加其它版本的Qt了，箭头可以切换Qt版本。 

------------------------------------------------qt vsaddin 2.6 end-------------------------------------------------------

          Qt路径设置后，再新建Qt程序，如下图，可以选择GUI程序和控制台程序，例如我创建的是GUI项目

          选择Qt版本与编译方式，选择debug即可，创建后，如果想用release发布，就在vs中换成release.

             项目解决方案如下：

       打开ui文件就可以拖拽控件了，如果你想手写ui也可以，新建Qt类即可，其它的编译调试和C++项目一样。

       如果windows系统版本过低，可能会编译失败，建议更新windows系统，至少更新到19041之后的版本。
       以上是VS2019 Qt开发环境的配置，一点说明：用VS Qt 开发的项目，尽量别经常换VS Qt的版本，VS2019至少可以用8-10年，Qt5.14也是很新的版本，不同版本的VS Qt在打开项目后，有可能无法编译，这种情况可以改好，稍微有点麻烦，如果你身边有C++老司机那还还说，不然一个人就很容易出问题的。

        VS Qt的项目也可以转化成QtCreator项目，改下配置和第三方依赖，跨平台时特殊的库用宏指定，如果不想跨平台， 那在VS上就随便搞了。

五、vs2019 Qt常见病症

     （1）windows QtCreator经常崩溃：windows上QtCreator经常未响应，崩溃，如何解决_C++/Qt/音视频/RTC-CSDN博客_qtcreator总是未响应

     （2）重装无法编译：一步解决Error while building/deploying project MyQtDemo (kit: Desktop Qt 5.7.0 MSVC2015 32bit) When exec_C++/Qt/音视频/RTC-CSDN博客

     （3）调试时出现 Unable to create a debugging engine ：一步解决QtCreator调试时出现 Unable to create a debugging engine_C++/Qt/音视频/RTC-CSDN博客

    （4）vs2019 qt打开ui文件闪退的解决办法：vs2019 qt打开ui文件闪退的解决办法_令狐掌门的博客-CSDN博客

      (5)  VS2019 Qt win32项目如何添加x64编译方式  VS2019 Qt win32项目如何添加x64编译方式_令狐掌门的博客-CSDN博客

六、我的Qt专栏

Qt 基础入门 Qt基础https://blog.csdn.net/yao_hou/category_10300102.html?spm=1001.2014.3001.5482

Qt 进阶专栏【收费，持续更新】 Qt高级进阶教程https://blog.csdn.net/yao_hou/category_9276099.html

QML基础入门  Qt Quick 入门教程https://blog.csdn.net/yao_hou/category_9951228.html

Python Qt基础入门  PyQt开发教程https://blog.csdn.net/yao_hou/category_9853212.html

Qt开源项目OBS源码分析  OBS源码分析https://blog.csdn.net/yao_hou/category_11128777.html

C++ Qt OBS源码分析视频课程【收费】：C++ Qt OBS源码屏幕录制软件开发视频教程https://edu.csdn.net/course/detail/36019

七、Qt高级开发视频教程
Qt高级开发视频教程https://download.csdn.net/course/detail/37447