QT for Windows安装配置总结及采坑问题汇总

一、安装包下载

1.Qt官方下载地址：http://download.qt.io/archive/qt/，选择对应系统的版本进行下载。如：http://download.qt.io/archive/qt/5.13/5.13.0/目录下的qt-opensource-windows-x86-5.13.0.exe安装包。

2.VS调试器：需下载Windows 10 SDK，来生成相关调试工具。下载地址：Windows 10 SDK。
  需强调的是该官方SDK只提供Windows 10版本的，但是Windows其它系统也是可以用的，直接下载安装即可。

Windows 10 SDK
适用于 Windows 10 版本 1903 的 Windows 10 SDK (10.0.18362.0) 可提供用于生成 Windows 10 应用的最新标头、库、元数据和工具。
使用此 SDK 生成用于 Windows 10 版本 1903 及旧版 Windows 的通用 Windows 平台 (UWP) 应用和 Win32 应用。

二、安装

1.Qt安装
  打开Qt安装包进行安装，因为Qt相关编译器及组件较多，建议自定义安装目录。走到“组件”安装步骤：如果使用MinGW编译器进行编译，那需要选择MinGW相关模块。而我们使用VS编译器编译，那么需要选择VS相关的编译器。同理Android和iOS编译的话，需要选择Android、iOS对应的编译器。

• 第1部分为不同类型的编译器，选择“MSVC 2015 64-bit”；
• 第2部分Sources包含Qt源码，选择后会将Qt源码部署到安装目录下；
• 第3部分为Qt中的模块组件，可根据实际开发需求按需选择。
    其中：Qt WebEngine模块为谷歌浏览器引擎；后缀带“(TP)”表示技术预览版组件。
• 第4部分为Tools组件，选择Qt Creator 4.6.1 CDB Debugger Support即可。
    其中：Qt Creator 4.6.1 CDB Debugging Support是VS编译器组件；
       MinGW 5.3.0是MinGW交叉编译工具；
       Strawbery Perl 5.22.1.3是Perl编译工具。
  
  2. Windows 10 SDK安装(VS调试器)
  安装SDK，只需选择Debugging Tools for Windows即可：
  

  执行下一步完成安装，后边在Qt中Debugger中会出现已安装调试器。

三、Qt Creator配置

我们首先看几个配置
1.Qt Version
  一般不需要配置，在Qt安装过程中已经选择好并安装，会自动检测到。最后在“构建套件(Kit)”中选择。

2.编译器
  编译器一般不需要配置，在Qt安装过程中已经选择好并安装，会自动检测到。最后在“构建套件(Kit)”中选择。

3.Debugger
  自动识别Windows 10 SDK中的Debugger，选择PC系统对应的64位Debugger。

注：如果无匹配的Debugger，那么需要自行安装，见上文二中“2. Windows 10 SDK安装”。
4.配置“构建套件Kit”
  上述配置完成后，进入“构建套件”,选择自动检测中的“Desktop Qt 5.11.0 MSVC 2015(默认)”，其中配置项包括：

• 设备为Local PC桌面类型；
• Qt版本默认自动选择；
• 调试器选择上文配置好的调试器；
• 编译器分别选择C与C++对应的编译器，已在上文已配置好。

若套件“Desktop Qt 5.11.0 MSVC 2015(默认)”上无红色、黄色感叹号，说明配置成功。
注意：一定要选择对应位数匹配的选项，如果配置不正确会出现感叹号警告。

四、遇到的问题

整个过程遇到了不少坑爹的问题，最终被我一一克服，下面对这些问题进行了梳理：
1.无MSVC2015对应的Debugger
原因：缺少Windows Debugger插件，按照上文步骤安装即可。

2.error: Expected token ","
原因：文件中存在中文，可尝试以下解决方法：

• 把中文字符串使用qstr包起来。
• 界面上随便按一下空格键，保存一下，这个界面上的所有这种错误就消失了。

3.error: msvc-version.conf loaded but QMAKE_MSC_VER isn’t set
解决方法：进入目录D:\Softwares\QT\5.11.0\msvc2015_64\mkspecs\common\，记事本打开msvc-version.conf文件，添加“QMAKE_MSC_VER = 1900”，如下图所示：

4.Error while building/deploying project qgroundcontrol (kit: Desktop Qt 5.11.0 MSVC2015 64bit) When executing step “Make”.

LINK : fatal error LNK1181: cannot open input file 'obj\QGCMapEngine.obj'
jom: F:\Ewatt-Work File\3QGC\build_MSVC2015_64_debug\Makefile.Debug [debug\QGroundControl.exe] Error 1181
jom: F:\Ewatt-Work File\3QGC\build_MSVC2015_64_debug\Makefile [debug] Error 2
14:56:27: 进程"D:\Softwares\QT\Tools\QtCreator\bin\jom.exe"退出，退出代码 2 。
Error while building/deploying project qgroundcontrol (kit: Desktop Qt 5.11.0 MSVC2015 64bit)
When executing step "Make"

解决方法：修改项目-Shadow build构建目录，将路径设置为工程所在路径。

5.提示缺少某组件
解决方法：那么需要添加或删除组件。运行Qt安装目录中的Maintainance.exe组件管理工具程序。

  选择“添加或移除组件”，但提示：至少需要一个有效且已启用的存储库。
需要设置远程代理存储库：

  点击“设置”，选择“存储库-临时存储库”，添加存储库路径(Windows)：http://mirrors.ustc.edu.cn/qtproject/online/qtsdkrepository/windows_x86/root/qt/，其他系统设置对应系统的路径。
  设置完成后，“添加或移除组件”页面就可以点击“下一步”进入同Qt安装时一样的组件选择页面了。