Qt Creator配置MSVC 2017套件保姆级教程：从环境变量到Kit设置，一步一图搞定

Qt Creator配置MSVC 2017套件全流程实战指南

第一次打开Qt Creator时，面对琳琅满目的配置选项，很多开发者都会感到无从下手。特别是需要配置MSVC 2017套件时，环境变量、调试器路径、编译器选择这些专业术语更让人望而生畏。本文将用最直观的方式，带你一步步完成从Visual Studio安装到Qt Creator最终运行的完整流程。不同于网络上零散的教程，这里每个步骤都经过实际验证，确保你按照指引操作后能立即开始Qt项目开发。

1. 环境准备：安装Visual Studio 2017与必要组件

MSVC编译器的核心来自Visual Studio，因此第一步需要正确安装VS2017社区版。访问微软官网下载页面时，务必选择**Visual Studio 2017 (version 15.9)**这个特定版本，而非最新的VS2022或其他版本。

安装过程中，工作负载选择尤为关键：

• 使用C++的桌面开发（必须勾选）
• Windows 10 SDK (10.0.17134.0)（版本号必须匹配）
• Visual C++工具集2017的x86/x64工具（编译器核心组件）

提示：安装程序默认不会包含调试工具，需在"单个组件"标签页中手动勾选"Windows 10 SDK调试工具"。

安装完成后，检查以下目录是否存在：

• C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx64\x64（64位编译器）
• C:\Program Files (x86)\Windows Kits\10\Debuggers\x64（调试器）

2. Qt 5.12.2安装与组件选择

从Qt官网下载5.12.2版本的在线安装程序，运行后进入组件选择界面。这里需要特别注意：

MSVC相关组件：

• Qt 5.12.2 > MSVC 2017 32-bit
• Qt 5.12.2 > MSVC 2017 64-bit
• Qt 5.12.2 > Qt Debug Information Files

额外工具：

• Developer and Designer Tools > MinGW 7.3.0 32-bit（可选，作为备用）
• Developer and Designer Tools > Qt Creator 4.8.2 CDB Debugger Support

安装完成后，验证以下目录：

C:\Qt\5.12.2\msvc2017_64\bin C:\Qt\5.12.2\msvc2017\bin

3. 系统环境变量精确配置

环境变量是连接Qt Creator与MSVC编译器的桥梁。右击"此电脑"选择"属性"，进入"高级系统设置"→"环境变量"，在系统变量中找到Path变量进行编辑。

需要添加的路径包括：

注意：添加完成后，需要重启计算机使环境变量生效。可以通过命令提示符运行cl命令验证是否配置成功——出现编译器版本信息表示配置正确。

4. Qt Creator套件配置全解析

打开Qt Creator，进入"工具"→"选项"→"Kits"开始配置构建套件。

4.1 编译器设置

在"编译器"选项卡中，点击"添加"→"MSVC"，然后分别配置：

• C++编译器路径：

  C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx64\x64\cl.exe

• C编译器路径：

  C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx64\x64\cl.exe

4.2 调试器配置

进入"调试器"选项卡，添加Windows SDK自带的调试器：

• 名称：CDB for MSVC 2017 x64
• 路径：

  C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe

4.3 构建套件组装

回到"Kits"主选项卡，新建一个套件并配置：

• 名称：Qt 5.12.2 MSVC2017 64bit
• 设备类型：Desktop
• 编译器：Microsoft Visual C++ Compiler 15.9 x64
• 调试器：CDB for MSVC 2017 x64
• Qt版本：Qt 5.12.2 MSVC2017 64bit

配置完成后，套件前的黄色警告标志应消失。如果仍然存在，检查：

1. 环境变量是否包含所有必要路径
2. 调试器路径是否正确
3. Qt版本是否与编译器匹配

5. 项目创建与部署验证

新建一个Qt Widgets Application项目，在"构建套件选择"界面勾选刚配置的MSVC2017套件。构建并运行项目后，如果需要在其他计算机上运行，需使用windeployqt工具打包：

windeployqt --release --compiler-runtime your_app.exe

这个命令会自动收集所有依赖的DLL文件到应用程序目录。常见问题解决方案：

• 缺少VCRUNTIME140.dll：从C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Redist\MSVC\14.16.27012\x64\Microsoft.VC141.CRT复制
• Qt插件未加载：确保plugins目录与可执行文件在同一级目录

配置过程中遇到问题时，可以尝试在Qt Creator的"帮助"→"关于插件"中禁用/启用相关插件，有时这能解决奇怪的兼容性问题。