一、为什么选择Qt5.12.10+VS2017组合？

在开始安装前，先明确版本选择的必要性：

• Qt5.12.10的优势：作为Qt5系列的最后一个LTS版本，它拥有长达3年的官方支持，兼容绝大多数第三方库和传统项目，相比Qt6系列对旧代码的兼容性更好，学习资源也更丰富，适合入门开发者和维护存量项目的团队。
• VS2017的必要性：Qt5.12.10对MSVC2017编译器的适配最为成熟，MSVC作为Windows平台原生编译器，在性能优化、调试工具集成上表现优异，是Qt开发Windows桌面应用的首选编译环境。

下面进入正式安装流程，分为Visual Studio 2017配置和Qt5.12.10安装两大核心环节。

二、Visual Studio 2017安装：Qt5.12.10的必备编译环境

Visual Studio 2017是Qt编译依赖的核心环境，正确选择组件是后续Qt安装成功的关键：

1. 下载Visual Studio Installer 2017

你可以通过官方渠道或国内镜像获取安装包，本文提供Gitee镜像链接（若链接失效，可前往微软官网下载社区版）：

https://gitee.com/carea/visual-studio/blob/master/VS2017/vs2017_Community.exe?svcp_stk=1_eHTdV7s-BH9tcaVlqiwCSoAh6kuFiLhUWsKs5A9IA1wC50j-Nsoxio9BNiLzvFEXkTLD3gGuZE2UBpeC73lyZpadKvJ1UyfPxmEsXg8ndltjnczPxqqwzDxNFukBOFTcDnXdOtcTA2WogE21_B5yyyMHF9fj8d3YoiwlrsvniWFYYcaOJ_SvL-WUpvmk1dwnBXaWOep_BqwPS2jwPsQJew%3D%3D

下载完成后双击运行安装包，等待安装程序初始化。

2. 选择核心工作负载与组件

进入安装界面后，重点选择以下内容：

• 必选工作负载：勾选「使用C++的桌面开发」，这是Qt编译Windows应用的基础环境，包含MSVC编译器、Windows SDK等核心组件。
• 冗余组件取消：展开「使用C++的桌面开发」的详细选项，取消勾选「Boost Test测试框架」「Google Test测试适配器」「Live Share协作工具」。这些组件并非Qt开发必需，取消后可减少安装体积（约节省5-10GB空间），避免不必要的环境冲突。
• 
  

3. 完成VS2017安装

点击「安装位置」可自定义安装路径（建议选择非系统盘，避免占用C盘空间），然后点击「安装」按钮，等待安装程序完成下载与配置。安装时间取决于网络速度，通常需要30分钟至1小时。

安装完成后，启动Visual Studio 2017并登录微软账号（可选），验证编译器是否正常：点击「创建新项目」，选择「控制台应用（C++）」，若能正常创建并编译运行HelloWorld程序，说明VS2017环境配置成功。

三、Qt5.12.10安装：核心组件选择与配置

Qt安装的关键在于组件选型，错误的组件选择会导致后续环境无法正常使用：

1. 下载Qt5.12.10安装包

Qt5.12.10官方安装包可通过Qt官网的「归档版本」下载，或选择国内镜像（如清华大学开源软件镜像站）以提升下载速度。注意：请勿选择Qt6.x版本，Qt6对旧版MSVC编译器支持有限，且与Qt5的API存在差异，不适合搭配VS2017使用。

2. 运行安装包并登录Qt账号

双击下载的安装包（通常为.exe格式），进入安装向导：

• 点击「Next」进入账号登录界面，若没有Qt账号，可点击「Sign Up」免费注册（仅需邮箱验证）。登录账号是为了获取Qt官方组件的下载权限，无需付费即可使用社区版组件。

3. 精准选择安装组件

这是Qt安装的核心步骤，务必严格按照以下要求选择：

• 必选组件：在「Select Components」界面，展开「Qt 5.12.10」目录，仅勾选「MSVC2017 64-bit」。这是Qt5.12.10针对VS2017 64位编译器的适配组件，是开发Windows桌面应用的核心依赖。
• IDE组件：默认勾选「Qt Creator 4.13.1」，这是Qt官方提供的集成开发环境（IDE），内置代码编辑、编译调试、UI设计等工具，是我们后续开发的主要平台。
• 其他组件取消：取消所有其他组件（如MinGW、Android、iOS等跨平台组件），这些组件针对非Windows平台开发，若不需要可节省大量安装空间（约节省20GB以上）。

4. 完成Qt安装

点击「Next」选择安装路径（建议与VS2017同盘，方便管理），然后点击「Install」开始安装。安装过程中可能会出现组件下载缓慢的情况，可暂停后更换网络环境或使用镜像源加速。

四、Qt环境验证：Kit配置与测试项目创建

安装完成后，需要配置Qt Creator的Kit工具链，确保编译器与Qt版本正确关联：

1. 打开Kit配置界面

启动Qt Creator 4.13.1，点击顶部菜单栏「工具」→「选项」，在弹出的窗口中选择「Kits」选项卡。

2. 验证Kit核心配置

Kit是Qt Creator中编译环境的集合，需要确保以下三个核心部分配置正确（可参考知乎专栏《Qt Creator配置Kit详细教程》的截图对比）：

• 编译器：选择「MSVC 2017 64bit」，这是VS2017安装的64位编译器。
• 调试器：自动关联Windows SDK中的调试工具，通常显示为「Auto-detected CDB debugger」。
• Qt版本：选择「Qt 5.12.10 MSVC2017 64bit」，确保与安装的Qt组件一致。

若某一项配置缺失，可点击「Add」手动添加：比如编译器缺失，可前往VS2017安装目录（通常为C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx64\x64）选择cl.exe。

3. 创建测试项目验证环境

点击Qt Creator的「New Project」，选择「Qt Widgets Application」，按照向导创建一个简单的UI项目：

• 项目名称自定义，路径选择非中文目录（避免编码问题）。
• 选择刚才配置的Kit，点击「Finish」创建项目。
• 点击左侧「运行」按钮（绿色三角图标），若能正常弹出一个空白的Qt窗口，说明整个环境配置成功。

五、安装常见问题与解决方案

1. VS2017组件安装失败：若出现组件下载中断，可关闭安装程序后重新运行，选择「修改」继续安装；或更换网络为有线网络，避免无线波动导致下载失败。
2. Qt组件下载缓慢：在Qt安装向导中，点击「Settings」→「Repository」，添加国内镜像源（如清华大学镜像https://mirrors.tuna.tsinghua.edu.cn/qt/），然后重新选择组件下载。
3. Kit配置提示编译器缺失：检查VS2017是否安装了「使用C++的桌面开发」工作负载，若未安装，需重新运行VS Installer添加该组件。
4. Qt Creator运行项目报错：检查项目的Kit选择是否正确，确保Qt版本与编译器版本匹配（MSVC2017对应Qt的MSVC2017组件），同时避免项目路径包含中文或特殊字符。

六、总结

Qt5.12.10搭配VS2017是Windows平台C++桌面开发的黄金组合，本文通过精准的组件选型、详细的配置步骤，帮助开发者避开安装中的常见陷阱。无论是入门学习Qt框架，还是维护企业级存量项目，这个稳定的环境都能满足需求。

https://zhuanlan.zhihu.com/p/662818678